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Preface 


This manual gives the normal operating procedures for DPS 7000 computers 
running under the GCOS 7 operating system. 


Main console and station operators should read this manual. 


Section 1 


Section 2 


Section 3 


Section 4 
Section 5 
Section 6 


Section 7 


Section 8 


Section 9 


Section 10 

Appendix A 
Appendix B 
Appendix C 
Appendix D 
Appendix E 


is a general introduction for the GCOS 7 main 
operator. 


is a practical guide to hardware initialization. 


is a guide to software loading, starting and terminating 
a session. 


deals with operations under GCOS 7. 
deals with facilities for running user jobs. 
deals with facilities for using peripheral devices. 


is an alphabetical presentation of GCL commands most 
used by the operator. 


is a continuation of the alphabetical presentation begun 
in Section 7. 


describes the Remote Multiplexed Operator Support 
(RMOS) facility. 


describes static and dynamic hardware reconfiguration. 
Operator-System Dialog on a Console 

Invoking System Utilities 

List of Commands by "Object" 

The SYS.URCINIT Printer Control File. 

WHEN, EVERY and RRESTART 
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Appendix F describes the device types and classes 

Appendix G describes how GCOS 7 handles dates before and after 
the year 2000. 

Appendix H describes how to use the Output Writer. 

V7000 Operator S Guide ...cccccccccccccccccceccceceteenteceseceseceeeeeneeeneeceeeeeeaeeaees 47 A2 74UU 

Printers Operator 8 Guide ......c.ccccccecceccecseeseeeececeteeeeseeetaeeeseeeeenseeasenaeeates 47 A2 00UU 

GCOS 7 Console Messages DireCtOry ..c.ccccccccccccccctsctsettetietcnecietieennees 47 A2 61UU 

GCOS 7 Messages and Return Codes Directory .....cccccccccscctteteteetsees 47 A2 10UJ 

CPU and Operator Station Manual (DPS 7/2x0/3x0 Models)........0.00+ 77 Al 51UU 

Operator Reference Manual (DPS 7000/2x0/3x0 Models) ......cccccccue 77 Al 52UU 

DPS 7000/An Operator's Guide...ccccccccccccccccccccecscetscetecenseeneseeecseeaeeaees 77 Al 71UU 

DPS 7000/5x0/7xx Operator's Guide ....ccccccccccccccscessceesceesseessesstecsseesseesaes 77 Al 81UU 

DPS 7000/MT xx Operator's Guide ...cccccccccccccccccscceccecneetecseesesneenaeens 77 Al 65US 


GCOS 7-V8 System Installation, Configuration and Updating Guide ....47 A2 19US 
GCOS 7-V9 System Installation, Configuration and Updating Guide ....47 A2 23US 


TDS Administrator's Guide ..cccccccccccccccccccceesceeseeeteeeneecnee cs eees secs aesnsesnaeenaeees 47 A2 32UT 
TDS COBOL Programmer's Manudl .0....ccccccccccccccceseeeeteteenet cee ceessenseees 47 A2 33UT 
TDS C Programmer's Manual ...c.cccccccccccccecscetcets sete ceeeseeeteceeeceeceenaeenaeens 47 A2 07UT 
High Availability CONCEDES ....cccccccccccccssecsteesseestecutecusecuseceseceseeeneeseseenseenaes 47 A2 22UT 
High Availability Administrator's Guide ....cccccccccsccetcesscesscesseeeseesseesseennes 47 A2 23UT 
Mirror Disks User's Guide ...cccccccccccccccccesceesceeseeecsccneeceeceecsecseenieeenaeeaees 47 A2 20UF 
GCL Programmer's MAnudl ......ccccceccecceeceeseeteenceeseeeecnseeaeeeeeneeeeateetenaeens 47 A2 36UJ 
IOF Terminal User's Reference Manual - Part 1.....ccccccccceseteseeteeteee 47 A2 38UJ 
IOF Terminal User's Reference Manual - Part 2.....ccccccccceseesetestetteetees 47 A2 39UJ 
IOF Terminal User's Reference Manual - Part 3 ...cccccccccccccccccsetseeteetsees 47 A2 40UJ 
GCOS 7-V8/V9 System Administrator's Manudl ........ccccccccceeeeteetettees 47 A2 54US 
Generalized Terminal Writer User's Guide...ccccccccccccccccsetetststetsteesteensees 47 A2 55UU 
Large Memory Cache User's Guide.i..cccccccccccccccsecssecctecnetceeceeseenseenaeens 47 A2 42US 
GCOS 7 Network User's Guide.....cccccccccccccccceccessceceeenseesseeneeeeseeseenseenaees 47 A2 94UC 
Remote Facilities DPS 7 tO DPS 6....cccccccccccccscesseetsecneenee cee nese eneenaeees 47 A2 11UC 
OFT US@r'S Guide isccccccvecistiuescieguicssceutsestestavacuagva sense veia ia veeliageee leva tees 47 A2 13UC 
DIP User's Guide: sscicisiccssestec es eevi aniieiesg tee Ge eka ee aan ena Has 47 A2 14UC 
DNS-V4 Terminal Management Reference Manual ..........cccccccceeeesecees 39 A2 24DN 
CNS7-A1 Terminal Management Reference Manual ..........ccccccccccecees 39 A2 43DM 
DSA Documentation Directory .....cccccccccccecceceeeecieecetcse tenses tneeetaeensseenenees 39 A4 9726 
ARM User's Guide ...ccccccccccccccsceesceesceseceeseeeeeeeeeeeceecseessaessaessseenesneeeaeees 47 A2 11US 

47 A2 53US 


Preface 


Administering the Storage MANdGe? ......ccccccccccccse cette tet ee tet ee tee tseenees 47 A2 36UF 
Distributed Operator an - Programmed Operator User's Guide... 47 A2 80UC 
Script Manager User's Guide .....cccccccsccsccsceeeceesneesnsesnetsecsecneeneenneees 47 A2 84UC 
File Recovery Facilities User's Guide ....ccccccccssccssssesscesscesscesseesseesseesseesnes 47 A2 37UF 
PRUGOOX (PR701/801/901) User's Guide ...ceccecccsscescessesseseeseeseesenseeens 47 A2 00UU 


Electronic Documentation 


The complete GCOS 7 document set is available on one CD disk. This product is 
known as CD-DOC. It is delivered foreach system and with each software or add- 
on delivery. 


This CD-ROM is updated each time a new GCOS 7 technical status is issued. 
Between 2 CD-ROM versions, manuals which have been updated are accessible, 
for reading or downloading, on a specific WEB site (link to this WEB site is 
available on the CD-DOC itself). 


Warning This manual describes all the GCOS 7 commands, some of them are only available 
if the hardware platform model supports the functionality. 
As an example: 


The GCOS 7 command Connect domain is only available on DPS 7000/MTxx 
and DPS 7000/Taxxx series. 
Mirror disks no more available on DPS 7000/XTA platforms 


Syntax The following conventions are used for presenting GCL (and JCL) command 
Notation syntax. 
ITEM An item in upper case is a literal value, to be specified 


as shown. The upper case is merely a convention; in 
practice you can specify the item in upper or lower 
case. 


item An item in lower case is a non-literal, indicating that a 
user-supplied value is expected. 


In most cases it gives the type and maximum length of 
the value: 

char105 a string of up to 105 alphanumeric 
characters 

name31 aname of up to 31 characters 

1ib78 a library name of up to 78 characters 
file78 a file name of up to 78 characters 

star31 a star name of up to 31 characters 


In some cases, it gives the format of the value: 
a a single alphabetic character 
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ITEM 


bool 


ts 


[] 


() 
+=$4*/-. 


EXAMPLE 1: 


[ 

[ 

[ 
Q) 


vi 


{ IMMED 
WHEN = { [dd.mm.yy.]. hh.mm  } ] 
{ +nnnn{w|D|H|M} }] 


nnn a 3-digit number 
hh.mm_ atime in hours and minutes 


In other cases, it is simply descriptive of the value: 
device-class 
condition 


An underlined item is a default value. It is the value 
assumed if none is specified. 


A boolean value which is either 1 or 0. A boolean 
parameter can be specified by its keyword alone, 
optionally prefixed by "N". Specifying the keyword 
alone always sets the value to 1. Prefixing the keyword 
with "N" always sets it to 0. 


Braces indicate a choice of values. Only one can be 
selected. 


Square brackets indicate that the enclosed item is 
optional. An item not enclosed in square brackets is 
mandatory. 


Parentheses indicate that a single value or a list of 
values can be specified. A list of values must be 
enclosed by parentheses, with each value separated by 
a comma or a space. 


Ellipses indicate that the item concerned can be 
specified more than once. 


Literal characters to be specified as shown. 
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This means you can specify: 


1. Nothing at all (WHEN=IMMED applies). 

2. WHEN =IMMED (the same as nothing at all). 

3. WHEN = 22.30 to specify a time (and today's date). 
4. WHEN = 10.11.87.22.30 to specify a date and time. 
5. WHEN =+0002W to specify 2 weeks from now. 

6. WHEN =+0021D to specify 21 days from now. 

7. WHEN =+005H to specify 5 hours from now. 

8. WHEN =+0123M to specify 123 minutes from now. 
EXAMPLE 2: 


PAGES = (dec4 [-dec4] [,dec4] ...) 
C) 


Indicates that PAGES must be specified. Valid entries are a single value, or a list of 
values enclosed in parentheses. The list can consist of single values separated by a 
comma, a range of values separated by a hyphen, or a combination of both. For 
example: PAGES = (2,4,10-25,33-36,78,83). 


EXAMPLE 3: 


[ REPLACE = { bool | 0 } ] 
QO 


This is a boolean parameter whose default value is zero. You can specify: 


1. Nothing at all (REPLACE = 0 applies) 
2. REPLACE =0 or simply NREPLACE 
3. REPLACE = 1 or simply REPLACE 
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1. Introduction to Running a System 
under GCOS 7 


1.1 Overview 


Running a system under GCOS 7 comprises the following three phases: 


1. Initialization and Power-On of the system, that is: 


— applying power to the hardware; 
— initializing the hardware by loading firmware (micro-programs); 
— loading the operating system, GCOS 7, into memory; 
— initializing this operating system. 
2. The operation phase proper: 
— starting and monitoring jobs until their output is delivered; 
— handling peripheral devices - printers, disk drives etc.; 


— managing certain system files; 
— correcting software and hardware incidents. 


3. Shutdown of the system. 


These phases are explained in Chapters 2 to 6 of this manual. This chapter provides 
a general introduction to: 


e the visible elements of a DPS 7000 system; 
e the role of a main operator; 


e the dimensions of GCOS 7. 
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1.2 


1.2.1 


DPS 7000 Systems - Hardware Overview 


DPS 7000/2x0 and /3x0 Systems 


e The Core Cabinet: The Core Cabinet is made up of a Power Module, the 
Central Sub-System (CSS) containing Central Processing Unit(s) (CPU), Main 
Memory Units (MMU) and Physical Channel Multiplexor Units; (PXU), the 
Service Processor (SPA), and an optional CNP7 (Communications Network 
Processor) for non-redundant models only (DPS 7000/2x0). 


e System/Service Console: The console consists of a screen, keyboard, logic pack 
and printer. Redundant models (DPS 7000/340/360/380) have two 
system/service consoles. 


e Peripheral Subsystems: Peripheral subsystems consist of peripheral processors 
(or controllers) and the devices they control. The DPS 7000/2x0 and /3x0 have 
the following range of standard peripheral subsystems: 


— MSS 4102 Mass Storage Subsystem(s); 

— MTS 4101 Magnetic Tape Subsystem(s); 

— DATANET 713X Network Processor(s); 

— MP XXXX Non-impact printing subsystem(s); 

— PRU 41XX Impact printers directly controlled by the SPA. 


The Service Processor 


The Service Processor (SPA) of the DPS 7000 is an independent unit running under 
its own Operating System, SPOS. DPS 7000/340/360/380 systems include two 
SPAs, a master and a back-up. Functions of the SPA include: initialization and 
testing of the Central Subsystem(s), maintenance and reconfiguration operations, 
control of the service console, and networking interface. The SPA can be accessed 
from Bull Technical Centers for remote maintenance purposes. 


In addition to the specific controller, connected by a PSI to the system, in which the 
SPA software can run, the SPA supports: 


e The MSCI (Maintenance Serial Channel Interface) to which are connected 
maintenance stations: 
— the MPA (Maintenance Processor Adapter), which is the maintenance station 

of the CSS, 

— the Power Monitor, which controls the power system. 

e A fixed mini-disk, and a 5.25" diskette unit. 

e The console subsystem. 

e Printer connections through the PDSI interface. 


On-line Tests and Diagnostics (OLTD) for Peripheral Subsystems and devices are 
controlled by GCOS 7 from the System console. 
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Operator Controls 
These controls are described in more detail in Chapter 2 Starting Up Your System. 


e The System Operator Panel (SOP) is located on the core cabinet, to switch the 
system on or off, or to re-initialize. 


e The system console controls the operation of the system. On dual-cabinet 
systems (DPS 7000/340/360/380 only), two consoles are available. 


e Maintenance panels, located in various processor cabinets, control the 
peripherals. 


1.2.2 DPS 7000/A Systems 


The DPS 7000/A is a compact system designed to enable both processing and 
peripheral functions to be integrated into a single cabinet, including not only the 
Central Sub-system and power units, but also 5.25" disks and cartridge tape units. 
The largest models also have an extension cabinet. Added to this, the following 
external peripherals can be connected if required: 


e MTS 4101 magnetic tape subsystem. 
e MP xxxx Non-Impact Printer. 
e PRU 41xx Impact Printer(s). 


Operator controls 
These controls are described in more detail in Section 2 Starting Up Your System. 


e The System Operator Panel (SOP) on the core cabinet, to send commands such 
as Power-on, Power-off, and Reset. 


e The Local Console is optional; it is implemented on a micro-computer, and 
presents a window-type interface. 
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1.2.3 DPS 7000/5x0/7xx/8x0/Dx0/Mx0 Systems 


A DPS 7000/5x0/7xx/8x0/Dx0/Mx0 system consists of a Central SubSystem 
(CSS), one to eight Input/Output SubSystems (IOSS), one or two Service 
Processors, two remote consoles (Remote Workstation and RSC) and several 
peripheral subsystems. 


These peripheral subsystems include: 


e Mass storage subsystems; 

e Magnetic tape subsystems; 

e Data communication subsystems; 
e Printer subsystems. 


The multiprocessor architecture of the Central Subsystem enables the 
DPS 7000/5x0/7xx/8x0/Dx0/Mx0 system to offer a wide range of configurations. 


1.2.3.1 DPS 7000/5x0/7xx Systems 


Central Subsystem (CSS) 
The Central Subsystem (CSS) is located in the CSS cabinet. It includes: 


e A System Controller Unit (SCU) which connects the System Bus (ASB) with the 
Memory Bus (AMB); 


e Up to six Central Processing Units (CPU) plugged into the ASB; 
e One to eight Memory Units plugged into the AMB; 

e One or two Input/Output Units (IOU) plugged into the ASB; 

e A Clock and Maintenance Unit (CMU). 


Input/Output Subsystem 


The Input/Output Subsystems are connected to the Central Subsystem (CSS) 
through one to four I/O busses (IOB) and to the peripheral subsystems through 
specific or standard interfaces. There are from one to eight Input/Output 
Subsystems (IOSS) each with a UMI Interface Adapter (UIA) and three Channel 
Multiplexer Units (CXU). 


1-4 47 A2 53US 


Introduction to Running a System under GCOS 7 


Power Subsystem Overview 


The power subsystem is based on the Auxiliary Function Service (AFS). There is 
an AFS in each CSS or IOSS cabinet and its basic components are: 


an AC control and filter module (ACC); 

one or several Power converter Modules (PM500); 
one or two Fan and Service Power modules (FSP); 
a system ENVIronment module (ENVI) 

a LOGistic control module (LOG); 

a Service Operator Panel (SOP). 


Optional features: 


e a Hold Up Power module (HUP); 
e an Electrical Motor Generator (EMG) to give AC power to a Service Processor. 


1.2.3.2 DPS 7000/8xx/Dx0/Mx0 Systems 
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Central Subsystem (CSS) 
The Central Subsystem (CSS) is located in the CSS cabinet. It includes: 


e A System Controller Unit (SCU) which connects the System Bus (ASB) with the 
Memory Bus (AMB); 


e up to 6 CPU slots, plugged into the ASB. Each slot can have four CPUs (Central 
Processing Units) that can be configured as IPs or EPs. (EPs are 
cO-processors). 


e One to eight Memory Units (MU) plugged into the AMB; 
e One or two Input/Output Units (IOU) plugged into the ASB; 
e A Clock and Maintenance Unit (CMU). 


Input/Output Subsystem (IOSS) 


The Input/Output Subsystems are connected to the Central Subsystem (CSS) 
through one to four I/O busses (IOB) and to the peripheral subsystems through 
specific or standard interfaces. 


The Input/Output Subsystems consist of one to eight IOSSs: 


e two MFB-IOSSs (Multi Function Bus) in the CSS cabinet, 
e and 4 to 6 MFB IOSSs in the extension cabinets. 
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1.2.4 


1.2.4.1 


Power Subsystem Overview 


The AFS (Auxiliary Function Service) provides the electrical power and cooling 
for DPS 7000 systems is based on the Auxiliary Function Service (AFS). Each 
cabinet contains one AFS sub-system. 


The AFS sub-system includes the following items: 


e one AC control and filter module (ACC); 

e one or more Power Modules (PM5P/PM700 and PMD); 

e one Power module for fan and Standby Power supply (FSP); 
e an ENVIronment control module (ENVI) 

e a LOGistics control module and fan DC power (LOG); 

e a Service Operator Panel (SOP). 


e a Hold Up Power module (HUP) to provide energy for voltage sag (up to 400 
milliseconds); 


e aredundant AFSR (except on DPS 7000/Cxx and /8xxS). 


The DPS 7000/4xx/Cxx Systems 


The DPS 7000/4xx/Cxx incorporates the powerful central processor of the 
DPS 7000/5x0/7xx systems with the miniaturized internal peripherals first 
introduced on the DPS 7000/A systems. 


The DPS 7000/4xx/Cxx Systems 


A DPS 7000/4xx/Cxx system includes one or two cabinets: 


e The basic cabinet, (which can be a complete configuration on its own). It 
contains: 
— a Central Sub-System (CSS), 
— two Input/Output Sub-Systems (JOSS), 
— up to nine disks and one or two streamers. 


e The extension cabinet. It contains, chiefly, an extra set of up to 15 disks, and 
two Input/Output Sub-Systems (IOSS). 


A Bull DPS 7000/4xx/Cxx system maximum configuration has one Central 
Sub-System (CSS), up to four Input/Output Sub-systems (IOSS), a Service 
Processor with a local console, two remote consoles (the RSC console and the 
remote maintenance console) and several peripheral sub-systems. 
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1.2.4.2 The Subsystems (CSS, IOSS, etc) 


Central Subsystem (CSS) 
The Central Subsystem (CSS) is located in the CSS cabinet. It includes: 


e A System Controller Unit (SCU) which connects the System Bus (ASB) with the 
Memory Bus (AMB); 


e up to 3 CPUs; 

e One to four Memory Units (MU) plugged into the AMB; 
e One Input/Output Units (IOU) plugged into the ASB; 

e One or two Service Processors; 


e A Clock and Maintenance Unit (CMU). 


Input/Output Subsystem 


The components of the Input/Output Sub-System are listed below. The IOSS is 
also illustrated by a diagram later in this chapter. 


e up to four Multibus2 Interface Adaptors (MIA) that connect the IOU of the 
system to the Subsystem controller. 


e two Multibus2 Maintenance Processors (MMP) which are common to the four 
IOSSs in the two Basic and Extension Cabinets. 


Different sub-system controllers can be attached to the Multibus2 interface: 


e up to six Mass Storage Processors (MSP). The ORU name for a SCSI drive 
and streamer controller is MSPD. 


e up to two Local Network Modules (LNM) which provide the connection to the 
CNP7-2 (dual LAN access) and up to forty lines. 


e an FCP7 controller for optical fiber link connection. 


e PNMisa PSI-(N) adaptor for any peripheral sub-system that requires a PSI 
interface. 


e PSM is a PSI-(S) adaptor for any peripheral sub-system that requires a PSI-S 
interface. 


e a WSP controller for Wide SCSI disk or cartridge subsystem connections. 
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e Printer interfaces can be either PRM (PRinter Module) or CPM (Centronics 
Printer Module). These two boards are used to connect printers that comply 
with: 


— Line Printer Programming Manual 


— Printronix (P series) and IGP (Intelligent Graphic Processor). 


Service Processor 


The Service Processor is based on a personal computer running specific 
applications under MS/DOS and WINDOWS™ type environments. 


Auxiliary Functions System (AFS) 


The AFS (Auxiliary Function Service) provides the electrical power and cooling 
for DPS 7000 systems. Each cabinet contains one AFS sub-system. 


The AFS sub-system includes the following items: 


e one AC controller and filter module (ACC), 

¢ one or more power modules (PM5P/PM700 and PMD), 

¢ one power module for fan and Standby Power supply (FSP), 
e an environment control module (ENVJ), 

e a logistics control module and fan DC power (LOG), 

e a Service Operation Panel (SOP), 


e a Hold Up Power module (HUP) to provide energy for voltage sag (up to 400 
milliseconds). 


e aback-up battery to protect the system against mains power failure shorter than 
ten minutes 


Peripheral Subsystems 
Disk Subsystems: MSP with 2.5 GB disks 

LSS shared with an Auriga system 

MSC4B with FSD500 or HI1000 disks (reconnection) 
Tape Subsystems ATP, CMTS, MTC-G (reconnection) 


Data Communications Datanet, CNP7, Extended-CP7, FCP7, OCS. 
Subsystems 


Unit Record Subsystems | MPC (SDI support for the ATP) 
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Printers PDSI interface - PR54, PR88, MP5050, MP6060, 
MP6090 
Centronics interface - PR90 
RS 232 and Dataproducts interface - PR800, PR900, 
PR701, PRU801, PRU901. 


1.2.5 DPS 7000/MTxx/TAxxx/TAxxxC Systems 


1.2.5.1 DPS 7000/MTx1 Non-redundant Models 
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The central processor subsystem (CPS) of the Bull DPS 7000/MT11, MT21, 
MT31, MT41, MT51, MT61 non-redundant models comprises the CSS cabinet and 
one service processor. 


The CSS cabinet contains: 


one Central Processor Unit, 

128 MB of main memory, 

one Input/Output Controller Unit, 

one Multi-Function Bus (MFB) enabling connection of up to 8 MFB channel 
controllers, 

e a power subsystem and power hold-up unit, 

e one MSPD controller with one cartridge streamer of 5 GB. 


The service processor (without hard-copy) can be located up to 15 meters away 
from the CSS cabinet. 


The basic and extension cabinets contain integrated peripherals (disks, cartridge 
streamer and network processor). 
System configurability limits 


The Bull DPS 7000/MTx1 non redundant systems are mono- or (optionally) 
bi-cabinet configurations with up to three optional Customer Dedicated Processors 
(CDP), up to 1024 MB of main memory and up to 32 MFB channel controllers. 


CPS Options 


All current MFB controllers are offered on the Bull DPS 7000/MT non-redundant 
models. 


All non-redundant models can receive one extension cabinet depending on 
customer needs for reconnection and new peripherals. 
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Peripheral Offer 


The new SDA 7 (Small disk Array 7) offer provides customers with the RAID 
technology. These disks are connectable to open systems as well. 


It is possible to reconnect current peripherals of the Bull DPS 7000/Cxx series to 
the Bull DPS 7000/MT non-redundant models, except the CDA (Cached Disk 
Array). 


1.2.5.2 DPS 7000/MTxx/TAxxx Redundant Models and TAxxxC models 


The central processor subsystem (CPS) of the Bull DPS 7000/MT42, MT52, 
MT62, MT72, MT82, MT83, MT84, MT86, MT88, MT92, MT96 TAxxx 
redundant models comprises the CSS cabinet, one I/O cabinet and two service 
processors. 


The CSS cabinet contains: 


two or more Central Processor Units, depending on the model, 

two CDP1 (Type-1 Customer Dedicated Processor), 

one back-up CPU board, 

256 MB of main memory, 

two Input/Output Controller Units 

one Dual Multi-Function Bus (MFB) enabling connection of up to 16 MFB 
channel controllers, 

e a power subsystem (with redundant power supply) and power hold-up unit. 


The I/O cabinet has one Dual Multi-Function Bus (MFB) that enables connection 
of up to 16 MFB channel controllers 


The two service processors (without hard-copy) can be located up to 15 meters 
away from the CSS cabinet. 


System configurability limits 


The Bull DPS 7000/MTxx redundant systems are bi- or (optionally) tri- cabinet 
configurations with two or (optionally) up to eight Customer Dedicated Processors 
(CDP), up to 2048 MB of main memory (with Bi-System Facility or Millennium 
Bi-System Test Facility) and up to 64 MFB channel controllers. 


The TAxxxC is identical but non redundant. 
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CPS Options 


All current MFB controllers are offered on the Bull DPS 7000/MT redundant 
models. 


All DPS 7000/MT and TAxxx redundant models can receive one additional I/O 
cabinet depending on customer needs for reconnection and new peripherals. 


To help resolve year 2000 problems, the Bull DPS 7000/MT/TAxxx redundant 
models can receive a factory-fitted option named Millennium Bi-System Test 
Environment which enables customers to test applications of the third millennium 
without disturbing their production system. 


Peripheral Offer 


All current peripherals of the Bull DPS 7000/8x0/Mx0 series are available with the 
Bull DPS 7000/MTxx/TAxxx redundant models. 


System configurability limits for peripherals are the same as those of the Bull 
DPS 7000/Mx0 series. 


It is possible to reconnect current peripherals of the Bull DPS 7000/8x0/Mx0 series 
to the Bull DPS 7000/MTxx/TAxxx redundant models and TAxxxC models, except 
MSC4 disk controllers with 1 GB disks. 
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1.2.6 DPS 7000/XTA systems 


DPS 7000/XTA system architecture is a new concept (eXtended Twin 
Architecture): the GCOS 7 operating system runs on an Intel™ processor server, 
concurrently with Windows™ operating system. It is a major evolution of the Twin 
Architecture (DPS 7000/ TA series). 


The figure below describes this new architecture: 


ORACLE8/8i/9 
SQL Server 


Figure 1-1. DPS 7000/XTA General Architecture 


1.2.6.1. DPS 7000/XTA cabinet description 


The DPS 7000/XTA is a compact system to enable both processing and disk 
peripheral functions to be integrated into a single cabinet. 


The 19” cabinet (19 U height) includes: 


e The DPS 7000 Base System Unit (BSU) server itself. 


e A Power Distribution Unit (PDU) to bring electrical power to the cabinet 
components. 


e An optional disk subsystem based on a RAID DAS subsystem. 
This disk subsystem is configured either as a Data Integrity (DI) configuration 
or as a High Availability (HA) configuration and may have a disk extension 
rack. 
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DAS Extension 


DAS 


DAS Redundancy Kit 


Figure 1-2. DPS 7000/XTA cabinet 
External peripheral subsystems can be connected or reconnected if required: 


e Raid disk subsystems: 
Connected through a FC adapter (for FDA 7 and CDA 7 reconnection). 
Tapes / Cartridges subsystems. 
Telecommunication processors: Mainway or Mainway LE 
Local Printers: Matrix printers (PRUx00, PRUx01, PRUx02, ...) 
These printers are connected in serial mode on an USB port through USB/serial 
port adapter 
e Network printers: Mathilde, .... 
Connected through customer LAN (Ethernet HBA). 
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DPS 7000/XTA server description 


The DPS 7000/XTA server is based on a 32 bits Intel™ Architecture server located 
in a 19” drawer. It is also called Base System Unit (BSU) and is composed of: 


e Central Processor Unit: Intel™ Xeon Family: up to 8 processors depending on 
DPS 7000/XTA model. 


e Main Memory based on DIMM technology with Error Correcting Code (ECC). 


e Input /Output controllers based on PCI or PCI-X technology: number of slots 
depend on model. 
These controllers are also known under the generic name Host Bus Adapter 
(HBA). 


e The different types of HBA are: 


— 10/100/1000 Mb/s Ethernet adapter for network connection. 
— SCSI adapter to connect tapes/ cartridges devices or disk subsystems. 
— Fiber Channel (FC) adapter to connect disk or tapes subsystems. 


e Internal devices: Several Devices are integrated in the server itself: 

Internal disks: Two disks: 

— | to support Windows™, V7000 software and several platform administration 
softwares. It is the server system disk (the one which is used when powering 
on or reboot the server). 

— It also contains the GCOS 7 disk generated in the factory and used to install 
the platform. It should not be considered as a customer reference disk (the 
customer reference disk or the second production disk has to be installed on 
external RAID subsystem). 

— The other one is used as a back-up, it is a copy of the Windows™ system disk 
described above. 


This disks are not used by GCOS 7 and customer programs, files or data bases. 


— AVDAT 4mm device is used to Import or export data on the Windows™ part 
of DPS 7000/XTA. 
This drive cannot be used by GCOS 7. 

— ACD-ROM and a floppy disk drives to install new software versions. 


e Power subsystem: 
This server is self-powered and cooled. 
The power unit is composed of 3 power modules. If one power module fails, the 
server is still operational and the failed power module can be exchanged without 
stopping GCOS 7 and the customer production. 
The fans are also redundant and can be exchanged without any customer 
production impact. 
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Power Distribution Unit description 


The PDU is a static component which allows to connect all cabinet components to 
a single electrical source, itself connected to the customer provided equipment. 
Only one power cord is required to connect the cabinet. 


The system can be connected to a customer provided external UPS (Un- 
interruptible Power System). 


GCOS 7 will be alerted when the power is delivered only by the UPS, and when 
the UPS will be discharged. 


Optional Disk subsystem description 


The DPS 7000/XTA cabinet can house an internal disk subsystem. 
Each model is always used with RAID1 configuration. 


Each model can be accessed with a single path (DI configuration) or a dual access 
(HA configuration). 


GCOS 7 System Operator's Guide 


Console operation 
The DPS 7000/XTA console operation is done through: 


e A local console connected directly to the DPS 7000/XTA server and composed 
of a standard 17” screen, an international keyboard (QWERTY) and a PS2 type 
mouse. 


e Aremote console: this remote console may be : 


— astandard workstation running under Windows™ operating system and 
connected to the customer LAN to remotely operate GCOS 7and V7000. 
Specific V7000 software has to be installed on such workstation. 
Operator can administrate or operate GCOS 7 and V7000 worlds. 


— a workstation or a laptop connected through the customer LAN ora phone 
line to operate the whole DPS 7000/XTA server. 
Terminal Service (Windows™ service) is used as connection software. 
Operator can administrate or operate GCOS 7 and Windows™ worlds. 


e Local Console printer facility: 
There is no direct console printing facility (as it is on DPS 7000/TA platforms). 
All the system activity is logged into a file and this file can be easily printed on a 
local printer connected to an USB port (one is systematically available for this 
function). 
This printer is not a part of DPS 7000/XTA offer and has to be provided and 
installed by the customer. 
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1.2.6.2 DPS 7000/XTA specific Initialization operations 
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As you have seen at the beginning of the §1.2.6, the general DPS 7000/XTA 
architecture is different from the previous DPS 7000 systems series. 


The coexistence of the 2 operating systems WINDOWS™ and GCOS 7 has 
modified the general initialization principle. 


Vv7000 
sYCc 
La 
we Ss SAM 
GCOS 7 
IOP: 
CPUs s Consels 


Figure 1-3. V7000 Description 


To understand the initialization mechanism, we have to present more in detail the 
GCOS 7/ V7000 and Windows™ organization: 


V7000 is composed of firmware and software parts which allow GCOS 7 to 
interface with Windows™ and the Intel™ platform. 


The System Control (SYC) software part initializes, starts and manages the 
firmware and hardware resources allocated to GCOS 7. 


The System Administration Manager (SAM) administrates the GCOS 7 
configuration, log files, maintenance tools and system utilities. 


The CPU and IOP firmware parts execute GCOS 7 instruction set and Input / 
output operations. 

The CPU part manages the hardware Intel™ processor without using Windows™ 
services. 

The IOP part uses Windows™ drivers to access the peripherals. 

The GCOS 7 console parts give operator access to GCOS 7. 

3 GCOS 7 consoles are available (LN02, LN03, LN04 resources). 
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When the system is powered on or reset the following steps are automatically 
executed: 


Power on self-tests to ensure that the hardware is ready to work. 


BIOS is started to recognize and configure the hardware components of the 
server. 


Then the WINDOWS™ operating system is started from the internal disk. 
The SYC service is automatically started. 


If the SYC automatic mode is set then the SYC service starts the ISL function 
which itself starts GCOS 7 (refer to § 3.3.1). 

The GCOS 7 reaches the GCOS 7 READY state without any operator action. 
The customer production is started depending on GCOS Start-up procedure. 


If the automatic mode is not set, the operator has to manually launch the 
GCOS 7 using SYC commands. See following chapters for more details or refer 
to V7000 Operator’s Guide 


1.2.6.3. DPS 7000/XTA specific administrator & operators principles 


As you have seen in the precedent paragraphs the first operating system to be 
loaded is Windows™, this peculiarity implies a new dimension in the administrator 
and operator definition. 

Users have to be declared by the Windows™ administrator. 


These groups and users will not replace current GCOS 7 access rights (Sysadmin, 
project, billings, ...). They will be used to manage and protect the Windows™ 
environment. 


V7000 first installation creates automatically 2 user’s groups: 


Vv7000Operators which gives control to SYC and normal system operation. 
The customer administrator has to create users in this group (people who will 
have to operate V7000). 

Note: Bull users should be created in this group to allow them to initialize, test, 
use the system as normal operators These users could also authorize Bull people 
to use the V7000 remotely. 


V7000BullServices, this group is reserved for maintenance people and gives 
control to specific tools (configure V7000, declare GCOS 7 disks, ...) 

Note: The customer administrator should not create customer users in this group, 
untrained persons may induce actions which can damage the customer 
production. 
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e Another implicit group is the Windows™ administrator group, this group is 
reserved to the customer people who have the authorization to administrate the 
whole system. 

Note: V7000 and Interoperability software installations need Windows™ 
administrator access rights. These tasks are normally done by Bull people. 
Therefore, the customer administrator will have to create (may be temporarily) a 
user in this group accessible to Bull people. 


The GCOS 7 administrator and operator dimensions are not changed (see §1.5). 


Refer to V7000 Operator’s Guide to have more details. 
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1.3 The GCOS 7 Operating System 


General Comprehensive Operating System (GCOS 7) is the main operating system 
of the DPS 7000 computers. GCOS 7 is loaded into Main Memory from the 
System Disk. 


The operator communicates with GCOS 7 through an operator console which may 
be the System console, although not necessarily so. 


Once GCOS 7 is loaded, it is in control of the DPS 7000 system. The operator's 
role is to influence and modify the practical operation of GCOS 7. He can control 
certain parameters and objects: the behavior of jobs, memory, devices, priorities, 
queues, classes, and many other elements. 


The main tools for the manipulation of these elements are the GCL (GCOS 7 
Command Language) operator commands, described in Sections 7 and 8, 
Description of the Operator Commands. 
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1.4 A GCOS 7 Session 


1.4.1 Initial System Load (ISL) 
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The ISL procedures are important to the system operator for the initial set up of the 
GCOS 7 system. Initial System Load (ISL) operations: 


e complete the loading of the operating system into main memory; 
e specify current and following session characteristics. 


These operations are selected among the optional replies to the ILO1 OPTIONS? 
question, the initial message to the operator after GCOS 7 is loaded. 


The RESTORE, RESTART, and BACKING STORE options are of special interest 
to the operator. ISL is fully described in Section 3 Starting and Terminating a 
GCOS 7 Session. 


Restore 


If segments in the SYS.BKST, SYS.TVMF, SYS.PVMF or SYS.LIB files have 
been corrupted, then these files must be restored from the SYS.SYSTEM file. At 
the completion of the restore a test is made of the state of all devices. Restore is 
also mandatory aftera SYS.SYSTEM update (CONFIG for example). 


Restart 


The system segments are correct, so now a particular restart is selected, depending 
on how the last session was terminated - normally or abnormally. The type of 
restart affects jobs, output, and characteristics from the previous session. 


1. Warm Restarts the session as closely as possible to the last 
session. Job and output processing is resumed 
following the same characteristics, e.g. 
multiprogramming level. If the termination had been 
abnormal, then some file and job salvaging is required. 


2. Cold This restart loses all existing jobs, but not necessarily 
output, or pre-initialized load modules. 


3. Clean A radical restart that loses jobs, pre-initialized load 
modules, network and session characteristics. 
However, the operator may request to recover the 
outputs. 
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Backing Store (BKST) 


Given that the size of main memory is limited, Backing Store files are used to 
contain permanent or temporary information and temporarily to store executing 
programs not being processed by the system. 


The Backing Store has three main functional elements: 


1. System Backing Store 


This comprises the static segments of the system contained in either a 
SYS.BKST or a SYS.BKSTO0 file. 


2. Permanent Backing Store 


It contains information kept from one session to another, restarted as COLD 
or WARM. 

It includes pre-initialized load modules, sharable modules, permanent Virtual 
Memory Files (VMF), and checkpoints. 

The permanent backing store is held on the SYS.LIB file and can be extended 
from SYS.LIB1 to SYS.LIB15. 

The permanent VMF backing store is held on the SYS.PVMF file and can be 
extended from SYS.PVMF1 to SYS.PVMFI1S5. 


3. Temporary Backing Store 


It contains session information, either non-repeatable user programs, or 
temporary system segments. 

The temporary backing store is held on the SYS.BKST files and can be 
extended from SYS.BKST1 to SYS.BKST15. 

The temporary VMF backing store is held on the SYS.TVMF file and can be 
extended from SYS.TVMF1 to SYS.TVMF15. 


Backing Store Files 
There are four types of backing store file: 


e SYS.LIB which may exist as up to 16 permanent paging backing store files 
(named SYS.LIB, SYS.LIB1 through SYS.LIB15) which contain pre-initialized 
load modules, sharable module libraries, and checkpoints; 


e SYS.PVMF which may exist as up to 16 permanent VMF backing store files; 
e SYS.TVMF which may exist as up to 16 temporary VMF backing store files; 


e SYS.BKST which may exist as up to 16 backing store files containing both 
permanent and temporary information, such as segments of the system, 
non-repeatable user programs. 
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A list of the volumes containing backing store files is retained from session to 
session; the operator can change this list at ISL time. Other characteristics which 
can be modified at ISL time include: 


e the list of resident volumes, 
e the list of volumes shared between two systems. 


1.4.2 Job Management 
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At System Initialization one final aspect of the system has to be selected - job 
management. This concerns the running of jobs, their introduction, scheduling, 
execution and output, and also the quantities or "load" of jobs that the system can 
know and handle at any one time. 


A key concept is multiprogramming. Given that more than one job can be 
executing at the same time, the maximum number of jobs executing has to be 
established. This load includes user and service jobs. It is an operator's 
responsibility first to select this maximum level and then to monitor it. This is a 
dynamic task that involves using the GCL commands. 


Similar kinds of operations can be established for scheduling jobs, where priority 
and priority class are used, and for outputting jobs, where levels of output are 
selected and then monitored, again using the dynamic control provided by the GCL 
commands. 


The Automatic Resource Management facility (ARM) optimizes system 
response time and throughput. It is based on a feedback concept which keeps the 
utilization of resources (such as the CPU, and the main memory) within specified 
ranges. 


ARM is described in Section 5 Running User Jobs Under GCOS 7, and in more 
detail in the ARM User's Guide. 
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1.5 The Role of the Operator 


Refer to §1.2.6.3 to see the specific administrator and operator dimensions on the 
DPS 7000/XTA platforms. 


1.5.1 Main Operator 


The various capabilities of a main operator to establish and monitor the system that 
were introduced in the preceding paragraph, are defined in the project established 
by the System Administrator. A short list of these includes: 


e The exclusive use of GCL commands that modify the functioning of the system 
(commands like MODIFY LOAD or START LOAD). 


e The management of hardware devices: printers, disks, etc. 


e Output management. 


1.5.2 Other Operators 


An operator can also assume other roles. He can become the network operator, with 
all the network control at his disposal. Or he can become the Master User of a 
TDS, with all the TDS control commands at his disposal. He can also become a 
RBF (Remote Batch Facility) station operator, with a special set of control 
commands. 


For a very general introduction to these roles, see Section 1.6 The Dimensions of 
GCOS 7. 


For further information on operator commands management, see the System 
Administrator's Guide. 
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1.5.3 GCOS 7 Control of Certain Operator Tasks 
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Increasingly, the task of organizing work is being transferred from the operator to 
the machine. 


The trend is to reduce operator intervention, for the following reasons: 


1. 
2; 
3. 
4. 


The operator may not be at the console when a request is issued. 
The operator may not take the best action. 
High volume of traffic. 


Multisite supervision by one operator. 


Operating systems often work 24 hours a day. Facilities intended to minimize 
operator intervention include: 


on-line media, 

remote printers at end-user sites, 

automatic reloading after a crash, 
user-defined applications for submitting jobs, 
programmed operator applications. 


The function of operators can be divided into two categories: 


1. 


Local operators manually operating devices such as tape drives, removable 
media, local printers. 


Operators responsible for different aspects of the system, for example TDS 
master console, network control, and system tuning. 
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1.5.4 Unattended Operation 


The automatic features of GCOS 7 include: 


Automatic Volume Recognition (AVR), 
Dynamic file extension, 

Starting jobs at predefined dates or times. 
Automatic initialization, 

Optional system console, 

Predefined replies to questions, 

Remote main operator, 

Programmed operator applications. 


Automatic initialization means that the system is initialized without any on-site 
manual operator intervention. Software loading may be automatically set up at the 
end of a previous session by use of the REPEAT option. In addition, the restart may 
take place in AUTO and SILENT or NSILENT mode. The identifier of the device 
from which the system is to be loaded at the next session may also be given while 
the system is running. These various possibilities are explained in Section 3.2 
Initial System Load (ISL) and the ILO1 Options. 


The Optional System Console means that the system, when initialized, can execute 
without the need for any operator log-on. The system continues to operate in 
unattended mode, provided that no operator action such as a recovery or a mount 
operation is required. 


Predefined Replies to Questions means that the System Administrator provides 
default replies to questions likely to be asked during initialization. 

The Remote Main Operator feature enables the main operator to log on through 
any terminal in the network, either on site or remote, instead of logging onto a local 
system console. 
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1.5.5 Operating a Large System 


Several main operators may log on simultaneously using the multi-console feature. 
They may have either the same or different access rights to system commands. The 
system administrator decides which commands a particular operator may use. 


On large systems, an individual operator may be responsible for a particular 
activity, for example: 


e device operations; 

e batch operations; 

e incidents affecting the system; 
e file handling. 


With any of the above responsibilities, a network operator becomes one of the main 
operators. 


1.5.6 Distributed Systems on a Network 
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Here the emphasis is on complementing local subsystems by providing software 
and operator services which cannot be easily operated on a smaller computer or 
which must be centralized for other reasons, for example administrative reasons. At 
the system control center, applications for execution on the satellites can be 
prepared. 


A main operator can control satellite systems using: 


e an asynchronous line of the switched network; 
e any terminal on the network if a link is made to the satellite; 


e asynchronous terminal with the Remote Multiplexed Operator Support (RMOS) 
facility which lets you simultaneously control applications on several remote 
sites. For more information on RMOS, see Section 9 Remote Multiplexed 
Operator Support (RMOS). 
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1.6 The Dimensions of GCOS 7 


The current release of GCOS 7 has two notable tendencies towards: 


e non-batch activities, that is, increasing interactive and transactional activities. 


e the increasing integration of any one system into a network of systems, with 
all of the distributed interaction that networking involves. 


1.6.1 The Batch Dimension 


Jobs submitted in batches must be monitored in the system. This may require 
manipulation of disks or tapes, which must be mounted or dismounted as required, 
and also responses by a main operator to the various questions, requests, errors, and 
processing levels that batch monitoring involves. 


1.6.2 The Interactive and Remote Facility Dimensions 


GCOS 7 supports interactive processing. This means that a user interactively 
accesses given domains, commands, and files, by which he gives work to the 
system. 


One way of looking at Remote Facility job processing is to regard it as interactive, 
but distributed over a network. Consider, for instance, the activities involved in 
Distributed Job Processing (DJP), in which: 


e jobs are submitted, monitored, and output on any machine in a network; 
e files can be transferred between machines in the network; 

¢ operator commands can control a remote site; 

e work can be re-routed from one machine to another in the network; 

e the station, at which outputs are printed, can be defined and modified. 


This concerns a main operator in two ways. First, he can assume the role of an 
interactive user, or a network and remote facility operator as required, with all their 
attendant facilities, commands, and responsibilities. 


Secondly, as main operator, he must ensure that these facilities are operated 
correctly. A main operator can monitor the load of jobs submitted and output by 
interactive users by using the following commands: CJ, MDJ, RJ, HJ, CO, HO, 
RO, and MDO. 
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1.6.3 The TDS Dimension 


When a system is transaction driven, programs known as Transaction Processing 
Routines (TPRs) are written by the user for his specific requirements. TPRs are 
triggered by appropriate data being introduced into this system. 


An operator, when required to assume the role of Master User of a TDS, has sole 
access to a set of privileged commands. These can start and stop the TDS, admit or 
remove users, open or close files, lock transactions and so on. 


A TDS job must not be submitted in the system start-up (see Section 3.3.6 System 
Startup) as this causes unexpected TDS behavior. 


For further information, refer to the TDS Administrator's Guide and the other 
manuals in the TDS documentation set (see list in the Preface). 
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2. Starting Up Your System 


The exact startup procedure depends on the type of DPS 7000 system. 


DPS 7000/A 


DPS 7000/2x0 and /3x0 


DPS 7000/4xx/Cxx/MTx1 


DPS 7000/A power-on and initialization operations are 
described in Section 2.2 below. 


If you need to modify the system parameters by 
running an Initial Storage Load (ISL) and answering 
the ILO1 OPTIONS question, refer to Chapter 3 
Starting and Terminating a GCOS 7 Session. 


DPS 7000/2x0 and /3x0 operations are described in 
Section 2.3 below. 


If you need to modify the system parameters by 
running an Initial Storage Load (ISL) and answering 
the ILO1 OPTIONS question, refer to Chapter 3 
Starting and Terminating a GCOS 7 Session. 


DPS 7000/4xx/Cxx operations are described in Section 
2.4. A diagram giving specific components of the 

DPS 7000/4xx/Cxx is in Section 2.4.6. Termination of 
the GCOS 7 session is described in Chapter 3 Starting 
and Terminating a GCOS 7 Session. 


DPS 7000/5x0/7xx/8x0/Dx0/Mx0/MTxx (2 42)/TAxxx/TAxxxC 


DPS 7000/5x0/7xx/8x0/Dx0/Mx0 operations are 
described in Section 2.4. A diagram giving specific 
components of the DPS 7000/5x0/7xx/8x0/Dx0/Mx0 is 
in Section 2.4.7. Termination of the GCOS 7 session 
is described in Chapter 3 Starting and Terminating a 
GCOS 7 Session. 
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2.2 


2.2.1 


DPS 7000/XTA 


DPS 7000/XTA operations are described in 

Section 2.5. A diagram giving specific components of 
the DPS 7000/XTA is in Section 2.5.7. Termination of 
the GCOS 7 session is described in Chapter 3 Starting 
and Terminating a GCOS 7 Session. 


The DPS 7000/A 


The control units of the DPS 7000/A are shown in Figure 2-1. 


Three things to remember about the DPS 7000/A: 


1. 


The DPS 7000/A can be switched on or off by operator command 


Both the Local Console and the SOP panel (see Figure 2-1) offer POWER 
ON, POWER OFF, or SYSTEM RESET commands. These are operational 
only if the AC power switch is physically on. 


The normal mode for powering on is Automatic mode 


When the system is in Automatic mode, hardware is initialized and the 
operating system loaded without any intervention from the operator. The 
complete procedure is described in the following pages. 


Of course, it is also possible to power on or initialize in manual mode, but this 
goes beyond the scope of this manual. For documentation relative to these 
procedures, refer to the DPS 7000/A Operator's Guide. 


The system must never be powered off without being terminated first 


System Termination is described in Section 3. Note that it is possible to leave 
the system powered on 24 hours a day. 


Using the DPS 7000/A Console 


A complete explanation of the console is found in the Operator Reference Manual. 


Below, there is a brief presentation of the console interface, and a set of procedures 
for doing the following: 


To power on or off the DPS 7000/A from the console without using a hardware 
switch. 

To send a reset command to the DPS 7000/A. 

To modify parameters such as automatic initialization or the disk from which the 
system is loaded. 
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SOP 


(top view) 
Open front door to 
pull SOP outwards. 


a 
NZ, 


NORMAL MODE 4 5 6 0 | |<— 


Lo 


DPS7000/A 
(front view) 


THE CONSOLE 


Implemented on a micro-computer, 
its user-interface is based ona 
windowing application. 

It remains an optional feature. 


MAIN BREAKER 


The Main Circuit Breaker is located 
at the rear side of the cabinet, 
behind a trapdoor. 

UP = ON 

DOWN = OFF 


AC LINE 


Figure 2-1. The DPS 7000/A Control Units 
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2.2.2 Introducing the DPS 7000/A Console 


The first screen visible (the Control Screen) on the DPS 7000/A console is shown 
below. If you are at the console, and other screens are displayed, it is always 
possible to return to this one by clicking on the CTRL icon. 


fo 


— 


INITIATIVES HARDCOPY F1—»+TENANT F9 —> DISCONNECT 
Linked to SYSTEM HARDCOPY ON 
MON AUG 21 09:12:00 CONTROL ON = Bull U1] 


To enter a command from the Initiatives menu: 
1. Press <F2> function key to obtain the CONTROL window. 
2. Click on the INITIATIVES menu. 


3. Click on the required command. 


Initiatives commands include Power On, Power-off, System Reset, etc. They are 
described in detail in the DPS 7000/A Operator's Guide. 
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2.2.3 Powering On the DPS 7000/A 


The normal operating mode of the DPS 7000/A is Automatic. Manual initialization 
is not used on the DPS 7000/A when in normal operation. 


1. Ensure that the console is powered on. If not, flip the console switch. 


2. Ensure that the AC power switch is ON. (See Figure 2-1. The AC power 
switch is located at the rear of the system. It should be up, with AC lamp lit.) 


3. Activate the power-on command on the console (see procedure given further 


on). 


4. Ifyou are in Automatic mode, Power On and Initialization occur without any 
further intervention (see below if that is not the case). 


5. Once the power-on and initialization phases are over, wait for the following 


message: 


hh.mm GCOS 7 RELEASE V6xx xxxx READY mmm dd, yyyy 


And if that does not work... 


Last message displayed on What to do: 


the console: 


I-MID xx READY 


ILO1 OPTIONS? I: 


*M INIT69 PRO1 
RECOVER.REPLY 
(UD, CR) 
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You are in MANUAL mode. In this case, 
1. Set automatic mode (See procedure below.). 


2. Enter a SYSTEM RESET command (See procedure 
below.). 


Refer to Chapter 3 Starting and Terminating a GCOS 7 
Session to answer the ILO1 OPTIONS question. (or Press 
<Enter> key to load with default options). 


You have the choice between: 

- taking care of the printer PRO! (mounting paper, for 
instance) and answering UD (Use Device), 

- or doing nothing, answering CR (Cancel Request), and 
doing without the printer. 


Refer to Chapter 6 Peripheral Operations for indications 
relative to printers. 
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2.2.4 Setting the DPS 7000/A to Automatic Mode 


At the console: 


1. CONTROL window 


2. INITIATIVES menu 


Press the F2 function key to obtain the CONTROL 
window. 


Click on the INITIATIVES menu, or press Alt I. 


3. MODIFY INIT PARAMETERS command 


4. Enter <1> 


Click on the MODIFY INIT PARAMETERS 
command. A dialog box appears. 


Press <1> after the blinking cursor, to select Automatic 
mode, then press <Enter>. 


5. Press <Enter> several times 


Press <Enter> several times, to accept the values of the 
other parameters. 


2.2.5 Power On or System Reset Command from the Console 


To enter POWER-ON or RESET commands from the console: 


1. CTRL window 
2. INITIATIVES menu 


Press F2 to obtain the CONTROL window. 
Click on the INITIATIVES menu (or press Alt I). 


3. POWER ON or SYSTEM RESET commands 
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Click on POWER ON or SYSTEM RESET commands 
of the initiatives menu. 


In the case of aSYSTEM RESET, a dialog box 
appears, with two options: YES and NO. Click on YES 
(or enter Y) to validate the command. 


The POWER ON command has no effect at all if the 
system is already powered on. 


Ifa COMMAND COMPLETED message appears, 
click on OK (or press <Enter>) to acknowledge it. 
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2.2.6 Service Commands: Reload (RL) and Restart (SR) on DPS 7000/A 


2.2.6.1 Reload Procedure 


This command is used after a TSYS GCOS (TERMINATE SYSTEM) command 
or after a System Crash. 


NOTE: 
The RL command is only necessary if the REPEAT parameter is not in force; 
see Section 3.3.8.4 Automatic Restart. 


To reload the system on a DPS 7000/A 


1. Obtain Service Console Call the INITIATIVES menu, then click the initiative, 
SWITCH TO SERVICE. (<Ctrl C> on the keyboard 
also works.) 


2. <Insert> Press <Insert> to visualize the SP: prompt of SPOS 
operating system. 


3. SP: RL To reload GCOS 7 


2.2.6.2 To Restart the System on a DPS 7000/A 


This command is used to force a system crash and terminate the system cleanly in 
the case of a system deadlock, for example. 


1. Obtain Service Console Call the INITIATIVES menu, then select the initiative 
SWITCH TO SERVICE. (<Ctrl-C> on the keyboard 
also works.) 


2. <Insert> Press <Insert> to visualize the SP: prompt. 


3. SP: SR To restart GCOS 7. 
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2.2.7 Powering Off the DPS 7000/A 


This procedure works if GCOS 7 is running. (If GCOS 7 is not running, use the 
POWER-OFF initiative: <F2>, <ALT-I>, <Enter> keys.) 


1. Obtain S: prompt in the SYSTEM window 
Press F1, then insert. If that does not work, read the 
appropriate console help text. 


2. TSYS GCOS PWROFF This command terminates the system, then powers off. 


3. Wait for jobs to terminate 
Termination time depends on what jobs are running. 
Refer to Section 3.5 Terminating The Session. 


NOTE: 
It may be necessary to terminate the telecommunications job, using the TTSVR 
TNS command. 


2.2.8 Setting Power On/Off Timers (MDPWR and DPWR Commands) 


Use MODIFY POWER_ TIMER (MDPWR) and DISPLAY POWER_TIMER 
(DPWR) to control the Power ON timer and Power OFF timer. Refer to both 
commands is Chapter 7 Description of the Operator Commands for further 
information. 
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2.3 The DPS 7000/2X0 and /3X0 


The control elements of the DPS 7000/2x0 and /3x0 are represented in Figures 2-2 
and 2-3. 


Two things to remember about the DPS 7000/2x0 and /3x0: 


1. 


The normal mode for powering on is Automatic mode 


When the system is in Automatic mode, hardware is initialized and the 
operating system loaded without any intervention from the operator. The 
complete procedure is described below. 


Of course, it is also possible to power on or initialize in manual mode. The 
procedure is described briefly below on the following pages. For more 
documentation relative to these procedures, refer to the Operator Reference 
Manual. 


The system must never be powered off without being terminated first 


System Termination is described in Section 3. Note that it is possible to leave 
the system powered on 24 hours a day. 


2.3.1 Powering On the DPS 7000/2x0 or /3x0 


On the Main Distributor — 1. Ensure that the power supply from the Main 


Board 


Distributor Board is on. 


On the System Operator 2. Check that the AC LINE indicators are ON, indicating 
Panel (SOP) that the system power is ON. 


3. Check that the SOP Switch is OFF (Figure 2-3). 


4. Set the Diskette unit switches to ON. 


On the control panels of the 5. Check that the Mains Circuit Breaker(s) are set to 
peripheral controllers ON. 


6. Set the LOCAL/SYSTEM switches to SYSTEM, or set 
the ON LINE / OFF LINE switches to ON LINE. 


On the console(s) 7. Set the ON/OFF switch to ON. 


On the SOP 8. Set the Mains Circuit Breaker(s) to ON. (On a 
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DPS 7000/3x0, set both Mains Breakers to ON.) 


9. Set the SOP switch to ON. 
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The DPS 7000/2x0 or 3x0 then outputs several pages of messages, without any 
operator intervention required. Finally, the following message appears: 


hh.mm GCOS 7 RELEASE V6éxx xxxx READY mmm.dd,yyyy 


KEKKKKKKKEKKKKKEKKEKRKKKEKKKKKKKKKE 


You can now press the <Transmit> key to log on, entering your user-name and 
password. 


And if that does not work... 

Last message displayed on the console: 

What to do: 

I-MID xx READY 

You are in MANUAL mode. In this case, key in: 


##MP AUTO 1 (to set automatic mode) 
##FS INIT 1 (to reinitialize) 


ILO1 OPTIONS? 
Ee: 


Refer to Chapter 3 Starting and Terminating a GCOS 7 Session to answer the ILO1 
OPTIONS question. (Press <Transmit> key to load with default options). 


*M INIT69 PRO1 
RECOVER .REPLY 
(UD, CR) 


You have the choice between seeing to the printer (mounting paper, for instance) 
and answering UD (Use Device), or else doing nothing and answering CR (Cancel 
Request). 
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The SOP Panel 


Init SPA Switches 


: | \ SOP Display 
Diskette Unit \ \. (CC is the normal code) 
Sy Ss 3 |] 
Le) NG nit» 
Main =| > == < Me 
Circuit > eae ~~ 
Breaker | | O |,_______ Init 1.0 SOP 
. Rw - <_ Switch 
~ 


AC Line Indicator \. eer teo mS 
Minidisk 


Warning: Keep the cover 
closed to avoid 
accidents. 


The Console 


The DPS7000/2X0 


Figure 2-2 The DPS 7000/2X0 Control Elements 
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Init SPA Switches 
\ SOP Display 
\\A (CC is the normal code) 
I =a Init eer bt 
ne Cic < 
N 


‘ Vi \ 
Init 1.© 


Main 
Circuit ye > 
Breaker / 


at 


a 
SS 


AC Line Indicator Minidisk 


Diskette drive (x2) 


Main 

Circuit | Mini Disk (x2) 
Breaker | if 

(x2) : 


The DPS7000/3X0 has 2 main consoles: 
one is called the Master Console, 
while the other one is the 
Back-up Console. 


The DPS7000/3X0 


Figure 2-3 The DPS 7000/3X0 Control Elements 
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Manual Initialization on the DPS 7000/2X0 and /3X0 


This is not the normal initialization procedure. 


This procedure is not necessary in the context of normal operation. But it may be of 
some use in the case of looping crashes, when the system enters a crash, reloads 
automatically, crashes again, in such a way that it is not possible to regain control. 


Commands keyed in by the Operator are given in bold type. Note that ## 
commands can be entered at any time, even if at the same time, the console is 


outputting a flood of messages. 


Procedure 


##MP AUTO 0 
##COMMAND COMPLETED 


##FS INIT 1 
##COMMAND COMPLETED 


I-MID xx READY 
<Break> 
I:LOADO 


>>>SPI01 DEVICE LOADER (0/2):0 


M SP0100 NO JOBS RUNNING IN 
SERVICE PROCESSOR 

##FM 

##MID OFF CALL 

SP:IN 


* ILO1 OPTIONS ? 
I: 


##MP AUTO 1 


Comments 


To set Manual mode 


To initialize 


To load SPI from the Minidisk 
(LOAD2 to load from diskettes) 


To load SPOS from the Minidisk (<2> 
to load from diskettes) 


SP: IN MS03 if you want to load 
GCOS 7 from MS03 disk 


When you have reached this level, 
you can modify the ILO1 OPTIONS, 
as indicated in section 3. Otherwise, 
you can enter <Transmit> to load with 
default options. 


When you have finished, it is 


necessary to set the system back to 
automatic mode. 
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Table 2-1 Functions of the DPS 7000/2X0 and 3X0 System Operator 
Panel 


MAIN CIRCUIT When this switch is ON (set at 1), the Central Subsystem 
BREAKER Units are powered on. 


AC LINE When LIT, it indicates that system power supply is ON at 
INDICATOR the main distributor board. 
DPS 7000/X0 and 3x0 


INIT SPA The INIT 0 switch initializes SPA 0. 
PUSHBUTTON 
The INIT | switch initializes SPA 1. 


This can also be done by typing in a command at the 
console. 

SOP DISPLAY Indicates the current status of the SOP by means of a 
two-digit display. 
See Operator Reference Manual, Section 3, for details. 


SOP SWITCH When this switch is ON (set at 1), it activates the Central 
Subsystem(s). It must not be switched on before the Main 
Circuit Breaker. 


manual utilization. 
DK UNIT SWITCH When this Switch is ON (set at 1), it activates the 
mini-disk normally used for initialization. 
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2.3.3 ASPA Configuration Parameters on the DPS 7000/2X0 and 3X0 


The ASPA (Ante Service Processor), which is activated when a 

DPS 7000/2X0/3X0 system is powered on, has a certain number of configuration 
parameters. Some of these parameters directly affect initialization mode and 
bootload devices. The values of these parameters are normally defined at 
installation time. 


The ASPA Configuration screen is illustrated in Figure 2-4. 


DKSL 
AUTO Selects mini-disk 
Select Automatic or diskette for SPA 
or Manual Mode image loading 
(see note 1) (see note 2) 
Cc: #H#MC 
HH ASPA CONFIGURATION HH 
HHSPSL (SPA SELECTION )=el ? 
\__>#HaAUTO (INITIALIZATION MODE ) =0 ? 
‘>> ##DKSL : (SPA BOOTLOAD DEVICE ) =0 ? 
A tHDVSL : (GCOS BOOTLOAD DEVICE ) = MSXX ? 
\\HHPASS : (REMOTE LOG-ON PASSWORD) = KKKKKKKKKKKK ? KKKKKKKKKKKK 
HHIDNT (SPA IDENTFICATION ) = XXX ? 
H#H#EPXM (ECHOPLEX MODE ON RMS ) = 0 ? 
#H#SPDM (SPEED SELECTOR FOR RMS) = 1 ? 
HH END OF CONFIGURATION HH 
DVSL 
Selects the 
default device for 
GCOS loading 


NOTES: 1. #HAUTO = 1 selects automatic mode 
##AUTO = 0 selects manual mode 


2. ##DKSL = 0 selects minidisk 
##DKSL = 2 selects diskette 


Figure 2-4 ASPA Configuration Screen 
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1. To display this screen and check the current values of the parameters: 
Type in ##MC 
2.  Ifitis necessary to modify a parameter: 


— Press <Transmit> to move to next line of screen. 
— Type in a new value. 
— Press <Transmit> to confirm. 


For example, to select MSO3 as the default GCOS 7 bootload device: 
Press <Transmit> 3 times 
Type in MS03 


— Press <Transmit> to confirm. 


2.3.4 Service Commands: Reload (RL) and Restart (SR) DPS 7000/2X0 and /3X0 
Systems 


The two commands described below are only meaningful when entered after an SP: 
prompt, with the console in SERVICE mode. 


2.3.4.1. Reload procedure (RL) 


This command is used aftera TSYS GCOS (TERMINATE SYSTEM) command 
or after a system crash. 


NOTE: 
The RL command is necessary only if the REPEAT option is not in force, see 
Section 3.3.8.4 Automatic Restart. 


To reload the system on the DPS 7000/2X0 or /3X0 
To reload GCOS 7 (after a TSYS 1 command, or after a crash), proceed as follows: 
1. ##AC Enter ##AC to switch from SYSTEM to SERVICE. 


2. <Break> Press <Break> to display the SP: prompt of SPOS, the 
service operating system. 


3. SP: RL To reload GCOS 7. 
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2.3.4.2 System Restart Procedure (SR) 
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This command is used to force a GCOS 7 crash and to terminate the system 
cleanly, in the case of a system deadlock for example. 


To restart the system on the DPS 7000/2X0 and 3X0: 

1. ##AC 

Enter ##AC to switch from SYSTEM to SERVICE. 

2. <Break> 

Press <Break> to visualize the SP: prompt of SPOS, the service operating system. 
3. SP: SR 

To force a GCOS 7 crash. 
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2.4 The DPS 7000/4xx/Cxx, DPS 7000/5x0/7xx/8x0/Dx0/Mx0 and 
DPS 7000/MTxx/Taxxx/TAxxC 


There are three processor families: 


e the DPS 7000/4x0/4x5/Cxx/MTx1 and the DPS 7000/5x0/7xx, 
e the DPS 7000/8x0/Dx0/Mx0, 
e the DPS 7000/MTxx/TAxxx/TAxxxC. 


The GCOS 7 operating system functions in a very similar manner on all these 

platforms. 

The main differences between the larger and smaller systems are in the peripherals: 

e the larger DPS 7000/5x0/7xx/8x0/Dx0/Mx0/MTxx/TAxxx/TAxxxC systems can 
include a vast number of external tapes, cartridges, disks and printers, 


e the smaller DPS 7000/4xx/Cxx/MTx1 systems have the miniaturized internal 
peripherals as well as a more limited number of external peripherals. 


2.4.1 Turning On and Off The System 


In normal mode the system is powered on by first turning on the power switches of 
each cabinet and of the Service Processor console. Then, the operator simply 
pushes the "on" button on the right of the System Operator Panel (SOP) of the 
BASIC/CSS cabinet. The SOP is the little pull-out panel, behind the front door, at 
the top of each cabinet. 


If the Programmed Operator Facility (POP) for an automatic initialization has been 
loaded in your service processor, the cabinets are powered on, the hardware is 
initialized and the operating system is loaded without any intervention by the 
operator. 


Note that it is possible to leave the system powered on 24 hours a day. 


The complete procedure, in normal mode, is presented in the flowchart below: 
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Switch ON ; 
all cabinet Breakers Remote Site. 


Push ON button ON TPC FP ON command 


(ON Timer value on RSC console 
on BASIC/CSS SOP reacted) 


——<__ SPON? 


Automatic 
SP power ON 


Reinit of tenant SP 


Windows started Reinit of backup SP 


SPV started Windows started 
Starting of RLH,PWC, SPV started 


TAH Starting of RLK,MSH 


Starting of PWC = 
automatic PW ON 
on PWC 


Starting of MSH 
Load Init CMU 


—— ~ No 
< AUTObitset > 


Yes 


End of startup 


Starting of SYC 
Command INR SCC 
initializing the system 

using the SCC parameters 
(boolload device) 


Starting of GCOS channel 
(LNH ...) 


SIP execution 


ISL execution 


There are other possible scenarios for power on and initialization, 
for example: 


- Manual power on using PWC (Power Control service) with the 
Service Processor ON, 


GCOS ready |- Automatic power on after a power shut down. 


GCOS starting 


Figure 2-5 DPS 7000/4xx/Cxx, DPS 7000/5x0/7xx/8x0/Dx0/Mx0 and 
DPS 7000/MTxx/TAxxx/TAxxxC Power On Procedure 
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2.4.2 Using the Consoles 


Information on the Consoles: 


The system is delivered with a basic configuration of 4 consoles. The configuration 
comprises: 


1. The Tenant Console of the four consoles available per system, only the tenant 
console is started automatically at initialization. 


2. The Backup console (optional). 


The two consoles above are microcomputers that contain the service 
processor. They are on site. 


3. The remote service console (RSC), 


4. The Remote Workstation is devoted to maintenance tasks. The operator 
cannot use this console, but he or she controls it from the Tenant Console. 


Information on Services: 
The consoles run applications called services. 


A service allows you to operate the service processor in window mode or in line 
mode. 


Each service has an appropriate function. For example, SYC and CFG services 
handle respectively Initialization and Configuration. 


The Screen Presentation: 
The first screen visible on the tenant console is shown in Figure 2-6. 


RLN (Remote Line Handler) service starts automatically at power on together with 
SPV (SuPerVisor), PWC (PoWer Control) and MSH (Maintenance Station 
Handler) services. 


For more information about the services, refer to the appropriate Operator's Guide. 
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RLH01 - Operatorless 


Log-On 


Welcome to RLH : Tuesday 27/02/90 19:22:06 

*“* RLH <PRES version 025.00> - Copyright @ BULL S.A. 1990**** 
*** RLH <BODY version 025.00> - Copyright @ BULL S.A. 1990**** 
*“** RLH <SPH_ version 025.00> - Copyright @ BULL S.A. 1990**** 


RLH108 COM1 is successfully opened by RLH 
RLH113 RLH is trying to connect to LOG board at : 27.2.90/19.22.17 


The TENANT Service Processor is connected on L1 line 


SCC VERSION 023L1 AURIGA SP READY 
02.27.90/19.22.19 


#HAM MI 
RLH236 RMS line is enabled by Initiative at 27.2.90/19.22.19 
##AM20 COMMAND COMPLETED 


Tuesday 27/02/90 19:22:47 Elapsed time 0:0 


Figure 2-6 Screen Presentation 
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2.4.3 Service Commands: Reload (RL), Restart (SR) 


Reload Procedure (RL) 


This command is used after TSYS GCOS (TERMINATE SYSTEM) or a System 
Crash. 


To reload the system: 


1. On the tenant console, call the SYC service by clicking on its icon in window 
mode, or type, EJR SYC in line mode 


2.  Atthe SYC prompt (SYC:), to restart GCOS 7, type this command: 
RL [S0|S1] 


SO is for system zero and S1 for system one when a bi-system is involved. 


Restart Procedure (SR) 


This command is used to force a system crash and terminate the system cleanly, in 
the case of a system deadlock, for example. 


1. On the tenant console, call the SYC service by clicking on its icon in window 
mode, or type: EJR SYC in line mode. 


2. Atthe SYC prompt (SYC:), to restart GCOS 7, type this command: 
sR [So|S1] 


SO is for system zero and S1 for system one when a bi-system is involved. 


2.4.4 Setting the Power On/Off Timers (MDPWR & DPWR Commands) 
Use MODIFY POWER TIMER (MDPWR) and DISPLAY POWER TIMER 


(DPWR) to control the Power On Timer. Refer to both commands in Chapter 7 
Description of the Operator Commands for more information. 
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2.4.5 Powering Off the System 


From the Tenant Console 

On the Tenant Console, under the PWC service, enter the command: 
PW OF (include the space) 

This command shuts down everything except the Tenant Console itself. 

To turn off the Tenant Console, enter this command: 


SPOF (no space) 


IMPORTANT: 
Do not enter SPOF from a remote console. With the Tenant off, there would be 
no way to reconnect without manual intervention at the computer site itself, 
which could be far away! 


So) 


From the SOP 
On the SOP of the BASIC/CSS cabinet: 


e Verify that you are in normal run mode. 


e With the keys, select either the command: 


NORMAL OFF This sends GCOS 7 a request to switch OFF; the 
system will switch off only when authorization returns 
from GCOS 7. 

or 


NORMAL EMER OFF This switches off the cabinet, but without requesting 
authorization from GCOS 7. It has the same effect as 
the POWER OFF initiative in the PWC service 
window. 
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2.4.6 
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The DPS 7000/4xx/Cxx/MTx1 


SOP 
(top view) 
Open front door to 
pull SOP outwards. 


The "on" or "target" 
push button 


1 }} 2]| 3 |) FI) > 


NORMAL alisllelloll« 
MODE 


BASIC/CSS 


REMOTE 
CONSOLE 


RSC 


MODEM 


EXTENSION/ 
loss 


DPS7000/4xx/Cxx/MTx1 


(front view 


) 


MAINS BREAKER 


The Mains Breaker is located 
in the rear of the cabinet. 


UP = ON They contain the service processor. 
DOWN = OFF 
Figure 2-7 The DPS 7000/4xx/Cxx/MTx1 Control Units 


TENANT 


THE CONSOLES 


Implemented on a microcomputer, 
they are based on a windowing application. 
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2.4.7 The DPS 7000/5x0/7xx 


SOP REMOTE 
(top view) CONSOLE 
Open front door to pull SOP outwards. 


1 || 2)| 3 || F1})~> 


NORMAL Zz 
MODE 4 5 6 0 | |< NG 


LY 


MODEM 


EXTENSION/ BASIC/CSS EXTENSION/ 
lOoSs 1OSS 


DPS 7000/5x0/7xx/8x0/Dx0/Mx0 
—o ee (front view 


) 
en (om 
tthe = 
r ~ 


ON) ON, oTiNE — 


LLLLLL 


MAINS BREAKER 


The Mains Breaker is located TENANT 
in front of the cabinet. 
UP = ON 
DOWN = OFF THE CONSOLES 
Implemented on a microcomputer, 
NOTE : The DPS7000/5X0 has the same control they are based on a windowing application. 
units without one IOSS Cabinet and They contain the service processor. 
without the Backup console. 


Figure 2-8 The DPS 7000/5x0/7xx Control Units 
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2.4.8 The DPS 7000/8x0/Dx0/Mx0/MT42 and UP/TAxxx/TAxxxC 


SOP 
(top view) REMOTE 
Open front door to pull SOP outwards. CONSOLE 


MANUAL MODE ]& MANUAL MODE |= 
SP OFF SP OFF 


Flo 


EXTENSION/ _BASIC/CSS EXTENSION/ 
1lOSs 1OSsS 


IO 


DPS 7000/8x0/Dx0/Mx0/MT42 and up/TAxxx/TAxxxC 


(front view) 


MAINS BREAKER 


TENANT BACKUP 


The Mains Breaker is located 
in front of the cabinet except for 


BASICICSS located in rear of THE CONSOLES 

the cabinet. Implemented on a microcomputer, 

UP = ON they are based on a windowing application. 
DOWN = OFF They contain the service processor. 


NOTE : The DPS7000/5X0 has the same control 
units without one |OSS Cabinet and 
without the Backup console. 


Figure 2-9 The DPS 7000/8x0/Dx0/Mx0/MTxx/MT42 and 
up/TAxxx/TAxxxC Control Units 
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2.5 The DPS 7000/XTA 
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The control unit of the DPS 7000/XTA is shown in §2.5.1 


1. 


The DPS 7000/XTA system can be switched off by operator command 
when terminating the Windows™ session. 

Note: before terminating the Windows™ session be sure that GCOS 7 and 
V7000 software are not running. 

See later on in this chapter (§2.5.3) the normal procedure to power off the 
system. 


The Normal mode for powering on is the automatic mode 

When the system is in automatic mode, hardware is initialized and the 
operating systems (Windows™ first then GCOS 7) are loaded without any 
intervention from the operator, the complete procedure is described in the 
following pages. 

Of course it is also possible to power on and/or initialize in manual mode: refer 
to the V7000 operator’s guide. 


The system must never be powered off without being terminated first 
System termination is described in section 3 (note that it is possible to leave the 
system powered on 24 hours a day). 
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2.5.1 Powering On the DPS 7000/XTA 


There is no main breaker in the cabinet. The power on/off operations can be done: 


e Using the control panel of the DPS 7000/XTA server located on the front side 
of the server drawer. It is accessible by opening the front door of the cabinet. 


The figure below describes switches and lights. 


eeee 


Figure 2-10 DPS 7000/XTA Control Panel 


A: Power switch: press to turn the system On or Off 

B: Power LED: when green, power is on. 

C: Status LED: when green, system is OK. 

D: Disks LED: When green, Internal disks are being accessed.) 

E: Sleep LED: when lit, the system is in the sleep (power saving) mode. 

F: Sleep switch: Press to put the system in the sleep mode (operating system has to 
support this option). 


e Using a remote connection (through LAN and or COM 2 serial port). 
When the server is administrated by the ESMPRO software, it is possible to 
use the Wake up LAN mechanism to power on the system remotely. 
This function is accessible to the customer on LAN and to the maintenance 
people using COM2 serial port. 


If the local power sequence is used, the local screen has to be also powered on to 
be able to follow the initialization process. 
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Table 2-2 LED information 


LED | Status Description Response 

Off Power OFF None required (normal) 
Power 

Green Power ON None required (normal) 

Red Power alarm Replace the power supply. 

Off Power OFF None required (normal) 
Status 

Turns off after lighting | Abnormal Check condition 

in amber 

Green 

(Steady light) No alarms None required (normal) 

(Flashing light) Abnormal Check condition 

Amber Abnormal Check condition 

Off Not accessing disk None required (normal) 
Disk drives 

Amber Internal disk drive Check disk drive status 

failure led 
Green Accessing disk None required (normal) 
DRIVES 

Off Sleep mode is off None required (normal) 
Sleep 

Amber (Lights 

immediately after Power-saving mode | None required 

power-on until POST (normal 

begins.) 
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2.5.2 Using the consoles 


How to access 
V7000 & 
GCOS 7 
services 
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The system is delivered with a local system console directly connected to the 
DPS 7000/XTA server, it consists of: 


e A17” screen 
e An international keyboard (US — QWERTY) 
e APS2 type mouse. 


There is no intermediate workstation (such as service processors on previous 
DPS 7000 systems). 


When using the manual mode, the V7000 services are accessible using the standard 
START menu from Windows™. 


The figure below shows this menu. 


x 
® Windows Update 


Programs 


> LE) Accessories r 

S Administrative Tools I? 
&"S Documents > =) startup > 
>< Emulex Configuration Tool 
fs v7000 4 =) Bull Services » 


Settings r 


Search > 
Operation Sup 


rE] Interop? 


Shut Down... 


Preneasreneneneesseessry, 


Figure 2-11 DPS 7000/XTA Windows™ Start Menu 


The entry point is the V7000 line of the programs menu. 
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(overview) 
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The customer operators may only have access to the following items: 
e System Control to give access to GCOS 7 world 


e Operation Supervisor to know what is active, who are the users currently 
logged, ... 


e Interop7 to administrate interoperability solutions between GCOS 7 and the 
open world (FTP, ESP7 , DA7,....) 


Note: The customer operators and administrator should not execute programs 
which are in the Bull Services menu, these services are reserved to Maintenance 
and support people. 


The execution of some of those services could have a negative impact on the 
GCOS 7 production when they are used outside the context for what they have 
been developed. 

The System Control service is used to manage GCOS 7: 

e Start, Terminate, Restart, Reload the GCOS 7 

e Set operational parameters (Bootload device, Automatic mode, ...) 

e Manage the GCOS 7 configuration (Exclusion list, ...) 


The paragraph gives an overview, the detailed description is given in the V7000 
Operator’s Guide. 


»+¥7000 System Control Bile Es 


| Action View | e = 


m/f &| 2 | 


Tree | 


¥7000(Local/S0) 


98) Activity history 


Time EventID | Description 
2001/04/02 16:56:13 8418 PX80 (Emulated I/O) allocate 
2001/04/02 16:56:13 8406 Physical Channels operatione 
2001/04/02 16:56:13 8407 GCOS? loaded, 
2001/04/02 16:56:13 8408 Memory absolutized, 
2001/04/02 16:56:13 8405 IPO0 allocated and mapped o 
2001/04/02 16:56:13 8409 SRST loaded in memory. 
2001/04/02 16:56:13 8411 Software activated on IPOO, 
“f 


Resources 


= 2001/04/02 16:56:13 8203 IN (Init) MSO1 successfully te ¥ 


Local SO: RUNNING | MASTER 
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Figure 2-12. V7000 System Control screen image 
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This is the screen you see when you select the System Control in the Start menu of 
Windows™, 


The activity history window lists all the previous actions and messages. The last 
message is marked with a blue arrow. 


How to change The different parameters used by SYC at a given time are accessible through the 
SYC Properties screen. You have access to these properties by right clicking on the 
parameters V7000 node (green icon in the above figure). 


¥7000(Local/SO) Properties 


Figure 2-13. V7000 Properties screen image 
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How to enter 
SYC actions: 
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In the first part of this screen you can select: 


The load device (GCOS 7 system disk): there is no more possibility to have a 
different bootload and ISL devices. 


The Time deviation. 
The automatic mode. 


The V7000 configuration file to be used at the next GCOS 7 initialization. (this 
parameter is normally managed by Bull Customer Service people). 


You have also an information screen to give you the current state of V7000: 


Is it running or not ? 


If it is running the load device and the configuration which were used at the 
previous initialization. 


The information concerning your own status regarding SYC control: 
MASTER means you have the control of SYC and you can do actions. 
SLAVE means that someone else is MASTER and he has the SYC control. 
Refer to V7000 operator’s guides to get more details. 


The following screen image shows the way you can enter actions. You may 
proceed in the same way as for accessing the Properties screen, by right clicking 
the V7000 node. 
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“¥7000 System Control 


| action view || > | Ga | co 2 | 2 


¥7000(Local/S0) 
4 Resources Inittinyy,.. 
0) Activity histe  Reload(RL)... 
Restart(SR)... 
Terminate({TS)... 


TakeGontral 


View 


Figure 2-14 SYC Action menu screen image 


Instead of selecting Properties, you can choose an action (in the top of the menu). 
These actions are contextual, which means that only those which are possible are 
selectable. In the above example the system is running (see status on the last line of 
the screen): the Init action is Grey. The operator may choose either: 


e Reload command: it has to be used after a GCOS 7 Terminate System 
command (TSYS). 


e Restart command: it has to be used to force a system crash and terminate the 
system as cleanly as possible, after a system deadlock for example. 


e Terminate command: it has to be used aftera TSYS GCOS 7 command to 
shut down correctly the GCOS 7 session before a new initialization procedure. 
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To launch a GCOS 7 session, the operator has to: 
e check initialization parameters (V7000 properties screen). 


e Enter Init command under V7000 to Start ISL operation then GCOS 7 
loading. 


How to launch To be able to control GCOS 7 you have to start a LN window (line mode window). 
aGCOS7LN_ 2 methods are available: 


Window 
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e A“Start LN02” dialog box appears to automatically start the LNO02 console. 


Start LNO2 xi 


Do you agree to start the LNO2 console? 


yo Hee | 


Figure 2-15. Dialog for automatic start of LN02 GCOS7 console 


e Itis also possible to use the V7000 service: V7000 Operation Supervisor 
(VOS) 
This service is accessible in the V7000 item of the START menu of Windows™. 


In the right part you have the list of LN consoles and information relating to 
each of them. 


You may start one of them by right clicking on the LN resource itself (client 
type). 


&) ¥7000 Operation Supervisor 


| Action View | + >| @\m|/2B|e 


Tree | 


lel Es 


Client Type / 
eon 


User Interfaces (Local) | === 


Status Number of User Int 


Computer Name | User Name 


FRCLS3309 
FRCLS3309 


Dianetest MASTER 


Dianetest 


Local/SO : RUNNING 


Figure 2-16. V7000 Operation Supervisor screen image 
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An LN can have several users at the same time, only one of them will be master 
and can enter commands in the window, the other users will have only the screen 
visibility, a Slave user can ask the master user to take control. 


3 GCOS 7 consoles are available and correspond to the LNO2, LNO3 and LN04 
GCOS 7 resources. 

Each of them can be used locally or remotely: one user is master and other users 
are slaves. 

Refer to V7000 Operator’s guide to have more details. 


When a LN is started, the window looks like the screen image below: 


@ELNo2 ~~ ~=LOCAL/so BEE 
File Edit View System Help 
| s BBM Pi Sl¢ O18 
17.01 Gcos7? RELEASE v780 WO41 READY ocT 31, 2000 
KHER EEEE 
17.01 x49 STARTED SAVE_SRV SYSADMIN $3 
alls) s[a)sl, > day STARTED LAEH OPERATOR Z 
ci 250 STARTED HSLV7000 SYSADMIN $s 
RSsO4 x49.1 WAITS FOR LOADING PROCESS 
RSO6 x49 REACTIVATED 
AD34 SECCL(0)24.1 SYS.AUDIT?.FILT FILE ACCESS FAILED, RC=4D101017->DcT 
LG 16, OBTUNKN 
SP06 X1 


SPO6 XL ARAHHEAAAARAAAAAARARAAAA RARER EERE RARER RARE EERE 
SP06 x1 * WELCOME ON GCOS- 7 V9 INSTALLATION * 


SPo6 eal PII abt Ci a So A AR OR Sono Ag A AS a A 
SPO6 x1 

SPO6 x1 PLEASE LOGON WITH : 

SPO6 x1 USERID=GCOS87 PASSWORD=G7 
SsPO6 x1 OR USERID=OPERATOR PASSWORD=OP 
sPpo6 x1 

SPO06 x1 THE DEFAULT MODE WILL BE GCLMODE 
eco1 USER/ PROJECT/ BILLING? 


|RUNNING [MASTER 5 a 7, 


Figure 2-17 GCOS 7 console screen image 


In this window you have the usual GCOS 7 visibility of all previous platforms. 
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Several little changes have been developed: 


When you want to enter a text for GCOS 7 (when asked by GCOS 7 or after 
entering the break command) you will have to enter the text in a separate 
window (line at the bottom of the screen). When the text is validated (Enter 
key) it will be placed in the normal GCOS 7 screen. 

This input line is only validated when GCOS 7 waits for an input, generally at 
the GCOS 7 prompt S: 


Full copy / past features 
Command editor 
Several font are possible 


... refer to V7000 Operator’s Guide to get more details 


All GCOS 7 commands are unchanged. (see the following sections of this manual). 


2.5.3 Powering Off the system 


Before powering Off the system, operator should take care of the following items: 
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GCOS 7 session is completely terminated. 

<< GCOS end of session message on the operator console (LN window). 
If GCOS 7 is still running, enter TSYS GCOS 7 command and wait for its 
completion. 


V7000 is terminated: have a look in the SYC Properties window to see the 
V7000 state. 

Refer to Figure 2-24. 

If V7000 is still running, entera terminate command under SYC service. 
Refer to Figure 2-25. 


Windows™ has to be terminated correctly: use shut down command in the 
Start menu of Windows™. 

When the Windows™ session is completed, and depending of BIOS 
parameters: 


Q amessage will indicate that you can manually power off the server: 
Press the power switch on the front panel of the server. 
Q The Server will be automatically powered off after Windows™ shut down. 
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2.5.4 Windows™ and GCOS 7 coexistence 


A system which uses 2 different operating systems has to be administrated 
carefully. 


V7000 and GCOS 7 software need a specific Windows™ configuration, as well as 
different independent software to manage the whole DPS 7000/XTA configuration. 
This configuration (Windows™ and software) is built in Bull factory or on site by 
Bull people if they need to re-install the Windows™ system disk. 


The DPS 7000/XTA platform is mainly dedicated to run GCOS 7 applications, 
whereas the Windows™ part is used to run: 


e GCOS 7 interoperability solutions 
e Software validated by Bull (Oracle, SQL net, ...) 


In any case, the customer is authorized to run standard Windows™ applications 
without the Bull agreement. 


Any change in: 


¥ Windows™ configuration (add or uninstall Windows™ components, uninstall 
independent software, ... ) 


¥ Windows™ parameters (change hardware configuration, network addresses) 
¥ Windows™ start-up conditions (automatic services, ...) 


may lead to unpredictable results regarding the V7000 and GCOS 7 production. 
All actions resulting in Windows™ registry modifications have to be analyzed in 
advance and, at least, Windows™ system disk should be saved before such 
operations. 


In case of doubt, contact Bull customer service to secure the operation. 
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Here are the W2000 options needed by V7000 and GCOS 7. 


v7000 

accessories & utilities 
SC 
a 
eC 
a 

document templates 

a 


minesweeper 


eS 
Cs 
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V7000 
SS 
eine 
SC 
es 
eC 


utopia sound scheme 


ee 
ee 


frontpage 2000 


a ee ee 
(HTML) 

2 
2 
ee 
a 


YES 
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oietsniony fp 

tc 
Internet authentication 

SS 

SS 

SS 

a 
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3. Starting and Terminating a GCOS 7 
Session 


3.1 Introduction 


This section describes the following operations: 


Initial System Load. 

Operating Modes: attended and unattended. 
Loading Operations: Attended Mode. 
Answering ILO1 OPTIONS question. 

Date and Time Management. 

Terminating the Session. 


Error Messages displayed During System Loading. 


These phases are the normal continuation from initialization, described in Chapter 
2 Starting Up Your System. 
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3.2 


3.2.1 


3.2.2 


Initial System Load (ISL) 


Purpose 


The Initial System Load (ISL) operation has a triple purpose. 


1. 
2: 


Operations 


Loading the operating system into main memory. 
Specifying the session characteristics, which are: 


— RESTART, which may be WARM, COLD, CLEAN 


— specification as to which disk volumes are to contain backing store files, 
which are to be RESIDENT and which are to be SHARED with a coupled 
system. 


— specification of options such as INIT (AUTO, NAUTO), REPEAT, etc. 
This is done by entering commands after the ILO1 OPTIONS ? question. 


Processing information left over from a previous session (e.g. dumps, PLMs, 
information on jobs and their associated outputs). 


The system status at the end of the previous session is displayed. 


Question ILO1 is asked which allows the selection of various options (DUMP, 
RESTORE, CLEAN, COLD, WARM RESTART, ...) and enables the operator 
to specify or modify elements of the session identity (resident, backing store 
or shared disks, etc.). Automatic storage load is described in Section 3.3 
Operating Modes. 


Manual storage load is described in Section 3.4 Loading Operations: Attended 
Mode, including the full set of ILO1 options. 


A DUMP session is executed if required. 
A RESTORE session is executed if required. 


The system checks the state of all the devices and starts the initial AVRs 
(Automatic Volume Recognition). 


A CLEAN, COLD, or WARM RESTART is executed. 
A message indicating that GCOS 7 is available is displayed. 
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3.3 Operating Modes 


3.3.1 Operating Modes 


Two operating modes are available. These are: 


e Manual mode, which requires a dialog between the operator and the system. 
e Automatic (or unattended) mode. 


At the end of system initialization, a MAIN operator may log on from any console 
with the required attributes, by entering the proper password or operator 
authorization when prompted by the system to do so. The operating mode of the 
session is determined by the INIT option provided at ILO1 with the parameters 
SILENT/NSILENT, AUTO/NAUTO. The parameters NAUTO and NSILENT 
indicate that the operator is going to perform the session manually whereas the 
other two, AUTO and SILENT indicate that subsequent sessions will start 
automatically. 


Note that the system catalog of messages is loaded during ISL instead of CONFIG 
in previous releases. The catalog is automatically reloaded: 


e after each RESTORE option, 


e if its creation date is different from that used during the previous session. 


3.3.2 Selecting a Console 


If the system initiates the first exchange, the system selects the console with the 
highest priority as found in the SRST. 


If the operator initiates the first exchange, he should enter a break on the selected 
console. In this case, the current mode becomes NSILENT and system messages 
are displayed until the system is ready. 


You can automatically switch from the current working console to another by 
entering a break on the new console. 
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3.3.3 Unattended Mode 


This refers to the ability of GCOS 7 to load itself without manual intervention. If 
the SILENT mode is set, then loading can take place with the console(s) off-line. 


The INIT (AUTO, SILENT), and REPEAT options provided at ILO1 are associated 
with UNATTENDED MODE. 


SILENT only messages requiring the operator to take action or 
reply to questions are displayed on the console. 


AUTO means that loading options are supplied automatically 
(on condition that the right subfiles are present; see 
below). 

REPEAT allows software loading to be done automatically after 


the TERMINATE SYSTEM command or after a 
system crash. 


The library members named RELOAD_OPTIONS (in the case of a GCOS 7 
reload) or INIT OPTIONS (in the case of a GCOS 7 reload preceded by a 
hardware/firmware reinitialization) supply default replies to the ILO1 question. 


The library member named H_SYS_REPLY supplies default replies to GCOS 7 
questions which are asked during initialization; it contains a predefined reply for 
each question key and subkey. 


RELOAD OPTIONS, INIT_OPTIONS and H_SYS_REPLY are stored in the 
SYS.HSLLIB default source library, and can be modified on the site. Each record 
of the file H SYS REPLY consists of: 


KEY = XXnn [SUBKEY = dec2] REPLY = ‘reply text' 


KEY is the question key containing two letters and two digits. 
SUBKEY is the question subkey containing two digits. 
REPLY introduces the reply itself. 


System components test the AUTO option and apply default values to those 
questions for which no reply was defined. 


Of course, manual operator intervention may be needed to answer certain 
questions, unusual requests such as device recovery or an error message preventing 
successful loading. 
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In this unattended mode, no system messages appear on your console but they are 
stored in the SYS.LOGC file. You may retrieve them later by using the 

DISPLAY CONSOLE LOG (DCLOG) command or by producing a printout. 
During software loading, all questions request a deferred reply in order to facilitate 
console configuration. If an incident occurs (for example, the system cannot find a 
console or is waiting for the operator to take an action), the system then enters a 
dynamic wait state in which it periodically tries to dialog with the operator. 


You may receive pending action messages on a local console. Once the operator 
takes the required action, unattended loading continues normally. 


3.3.4 Operator Commands Allowed During GCOS 7 Initialization 


To activate the system, enter a break. During storage load, you can only reference a 
subset of the GCOS 7 main operator commands: 


START_DEVICE (SDV) 

CANCEL REQUEST (CR) 

MODIFY_ VOLUME (MDV) 

NAME_ VOLUME (NV) 

DISPLAY_TIME (DTM) 
DISPLAY_CONSOLE_LOG (DCLOG) 

REPLY (REP) 

MODIFY_CONFIGURATION CLM (MDC CLM) 
DISPLAY REQUEST (DR) 


3.3.5 Console Failure 


If the console in use fails or becomes unavailable, for example goes off-line, the 
operator may interrupt the loading procedure. 


To select another console which is to be dynamically reconfigured, see Section 
3.3.2 Selecting a Console. 


If the system sends a message requiring the operator to take action, for example, 
setting a device on-line or physical exchange of a device, the system re-issues the 
message until a console becomes available. 
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3.3.6 System Startup 


Once the loading is completed, and just before the system is declared ready, a 
startup procedure named SYSTEM is executed automatically before any queued 
job is restarted. The absence of the member SYSTEM in the library 
SITE.STARTUP does not prevent the system from operating. 


The purpose of the SYSTEM startup is to execute a set of installation-specific 
commands before operators or users log on. 


The startup can: 


e start telecommunication sessions, 
e set up specific parameters, for example, job classes. 


For sites without a local console, these facilities allow you to: 


e connect a remote operator, 
e start a RMOS session (see further on). 


Interactive processors cannot be activated on the SYSTEM startup. 

SYSTEM startup is a set of commands (by default, these commands are in GCL 
language) with sequences which may depend on switches themselves set by the 
type of restart: 


SWl is set on fora WARM RESTART. 

SW2 is set on fora COLD RESTART. 

SWw3 is set on fora CLEAN RESTART. 

SWw4 is set if a dump is present in the SYS.SYSDUMP file. 


SWS and SW6 concern coupled systems configurations: 

SW5 = 0 and SW6= 0 the local system is not configured as part of a coupled 
system (it is independent). 

SW5 = | and SW6= 0 coupled systems configuration: the local system is 
even. 

SWS5 = 0 and SW6= 1 coupled systems configuration: the local system is odd. 


NOTES: 


1. The SYSTEM startup commands can also be in JCL, in which case the 
switches are numbered from 0 to 5. 


2. ATDS job must not be submitted in the system startup as this can cause 
unexpected TDS behavior. 
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System Ready Transition 


When the SYSTEM startup is executed, the Operator Message Handler (OMH) is 
automatically activated in job class Z. This job becomes an integral part of 
GCOS 7. 


During the initialization of the OMH job, system messages are not normally 
displayed on the operator terminal and breaks are inhibited for a few moments. 
However, no messages are lost and if you wish, you can retrieve them from the 
SYS.LOGC file. 


If OMH does not start, you cannot start a job. To correct the software error, call the 
Service Center. See the Operator's Guide for the platform concerned for an 
explanation of the maintenance procedures. 


Because you may wish to operate in unattended mode, or do remote operations, the 
system, when ready, does not request the MAIN operator to log on. 


Loading Operations: Unattended Mode 


Certain operations can be performed without operator intervention: 


e Initial System Load (ISL) 
e restart after a crash. 


The parameters which affect automatic operations are the AUTO parameter of the 
INIT option and the REPEAT option provided at IL01. 


The AUTO parameter permits an automatic reply to the ILO01 OPTIONS question 
and REPEAT permits software reloading without operator intervention after a crash 
or after TERMINATE SYSTEM. The INIT and REPEAT options can be displayed, 
set or modified during the GCOS 7 session by using the 

DISPLAY RESTART OPTIONS (DRSO) and MODIFY RESTART OPTIONS 
(MDRSO) commands. 
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3.3.8.1 


DISPLAY_RESTART_OPTIONS (DRSO) Command 


Displays the following system initialization parameters: 


automatic restart option 
silent restart option 

automatic repeat option 
the initialization device 


{DISPLAY RESTART OPTIONS} 
{DRSO } 


EXAMPLE: 


DRSO 


>>16.13 AUTO=0/0 SILENT=0/0 REPEAT=0 
SYSTEM DUMP AVAILABLE 
ANTESP SWITCH IS OFF INIT=MS17 
Q) 


NOTE: 
For a description of the values displayed, refer to the DRSO command in 
Chapter 7 Description of the Operator Commands. 


3.3.8.2 MODIFY _RESTART_OPTIONS (MDRSO) Command 


3-8 


Modifies the system initialization options for the next restart only, after a crash or a 
TERMINATE SYSTEM command. (See Section 3.3.8.3 Automatic Reload for 
modifying initialization parameters for all subsequent restarts.) 


{ MODIFY RESTART OPTIONS } 
{ MDRSO } 


[REPEAT = bool] 


[AUTO = bool] 
[SILENT = bool] 
[{DEVICE} ] 
[{ } = MSxx J 


[{DV } ] 
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Parameters 


REPEAT 


AUTO 


SILENT 


DEVICE 


Constraints 
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when 1, the next system shutdown or crash is 
immediately followed by a restart, reload or re- 
initialization (depending on the system and the cause 
of the shutdown) without any operator intervention. 
This operation takes into account the disk unit 
identification stored in the service processor through 
the DEVICE parameter. Consequently, when REPEAT 
is set to one the operator must check the device 
identification stored in the service processor. When 0, 
the next system shutdown will require a manual 
intervention from an operator to restart the system. In 
the case of CRASH the system is restarted and 
reloaded automatically, taking into account the unit 
that was the system disk in the current session. This 
operation is necessary to process consistently the 
DUMP related to the CRASH. 


when 1, the next system restart (whether with or 
without operator intervention) is automatic, 1.e. does 
not ask the operator any question, provided that default 
replies have been stored in the RELOAD OPTIONS 
library member, as appropriate. When 0, the next 
system restart is run by the operator who is asked 
questions. 


when 1, the next system restart (with or without 
operator intervention) results in no message being 
issued on the operator console; when 0, messages are 
issued. 


this parameter is used only on DPS 7000 systems. It 
specifies the disk unit from which the operating system 
is to be initialized. Unlike the other parameters, this 
option is retained for all subsequent system 
initializations until another MDRSO command is 
issued. 


If AUTO = 0 then SILENT is ignored. 
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EXAMPLES: 
MDRSO AUTO SILENT (Next restart asks no question and issues no message.) 


MDRSO REPEAT = 0 (Manual intervention is required to initiate the next 
restart.) 


Q) 


To display the repeat, restart, silent restart, and initialization device options, use the 
DISPLAY RESTART OPTIONS command described in Section 3.3.8.1 above. 


3.3.8.3. Automatic Reload 


The "ILO1 OPTIONS" question is asked at the local console during a Reload 
(subsequent to a TSYS command or a crash), on condition that INIT (NAUTO) is 
set. If INIT (AUTO) is set, answers are read from disk. Note that setting INIT 
(AUTO) at the ILO1 OPTIONS question applies to all subsequent reloads, but that 
the value set by the MDRSO command applies only to the next reload. 


When the whole system is (re)initialized in unattended mode (auto-hardware mode) 
the reloading of GCOS 7 is automatic, even if AUTO was not set at the end of the 
GCOS 7 session. In this case the INIT OPTIONS member is used to answer the 
ILO1 OPTIONS question. 


3.3.8.4 Automatic Restart 


This is controlled by the REPEAT option provided at ILO1 parameter. If repeat is 
set to OFF a manual restart is needed after the end of a GCOS 7 session. 


REPEAT can be set so that an automatic restart is made after the end of session or a 
crash. One way is to use the MDRSO command, but this is only effective for the 
next restart. The other way is to set the REPEAT Option, with no parameters, as 
one of the replies to the ILO1 question. You can additionally use the minutes 
parameter of the REPEAT Option, which allows the user to set a minimum time 
between automatic restarts of crashes. If two consecutive crashes occur during this 
time, Auto mode is stopped. 
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3.3.8.5 Cancelling Auto Mode 


There are two ways to cancel Auto mode: 


e By using the MDRSO AUTO=0 command, when GCOS 7 is running. After a 
crash or a shutdown, for the next GCOS 7 restart only, the ILO1 question will be 
asked at the system console. 


e By using the prerecorded reply, INIT(/NAUTO), to the ILO1 question, after a 
crash or shut down, for example. In this case, the Auto Mode cancellation only 
becomes effective for the subsequent GCOS 7 sessions, but not the session being 
started. 


Modification to the preregistered answers to ILO1 must be done by an update to the 
RELOAD OPTIONS library member. 


NoTE: 
By using both of the above possibilities you can cancel Auto Mode for the next 
and subsequent sessions. 


3.3.8.6 Dump Facilities in Automatic Mode 


AUTO and REPEAT modes are necessary for an automatic restart in case of 
crashes. For dump storage after crashes in automatic mode the following 
commands should be registered in the RELOAD OPTIONS library member: 


DUMP(DISK) This permits the dump option commands to be 
retrieved from DUMP_CD parameters, instead of from 
the console. 


DUMP._CD (O,volnm,DEF; EXEC,DPS_STD;END;) 
This stores the commands which save the GCOS 7 
dump in the SYS.SYSDUMP file. A standard dump is 
produced. 


In the case of a crash dump in automatic mode the question CRASH 
COMMENTS? is not issued and the reply "AUTO" is provided by the system. 


See Section 3.4.3.5 DUMP for a detailed description of Dump facilities. 
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3.3.8.7. Abnormal Events During First Phase of GCOS 7 Loading (ISL) 


In AUTO mode, any abnormal event occurring during the first phase of GCOS 7 
loading (ISL) and for which no response is automatically provided by the system or 
for which an operator action is needed, leads to display of the related ILxx error 
message prefixed by the "##FW" character string: 


#HEW ILxx ....... 


The system then enters an endless loop. The error must be corrected and a new 
Initial System Load executed, or the hardware and firmware must be manually 
reinitialized as described in Chapter 2. 


If an I/O error occurred on system files (SYS.BKSTi, SYS.LIBi, SYS.PVMFi, 
SYS.TVMFi) during last GCOS session, the message IL21 will be displayed and 
the AUTO mode will be stopped (IL72). In this case, the ILO1 question is then 
displayed to the main operator in order to modify the corresponding list of system 
files. 
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3.4 Loading Operations: Attended Mode 


The ISL banner consists of two or three lines. The first line shows the technical 
status of ISL components: 


>>> ISL-vvv.v xx -n (aa bb...) / yy -m (cc dd ...) 

where 

VVV.V = version.revision 

Xx -n (aa bb ...) refers to SERs (Software Error Report) for INIT of 
ISL, where: 


xx = highest SER rank 
n= number of missing SERs 
aa bb ... = ranks of missing SERs 


yy -m (cc dd...) refers to SERs for DPS of ISL, where: 
yy as for xx 
mas forn 
ce dd ... as for aa bb 


The second line shows the current local date, time and the time deviation value, 
when available: 


>>>HH:MM:SS month DD, YYYY TIMEDEV=+01.00 


NEW TIMEDEV is used instead of TIMEDEV if the time deviation value has 
changed. 


The third line shows the channel number of the ISL device (LOAD PCLC) 
preceded by the channel number of the hardware device (INIT PCLC), when Initial 
System Load occurs just after the INIT phase: 


>>>LOAD PCLC = Chnl 
or 
>>>INIT PCLC = Chni LOAD PCLC = Chn2 
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3.4.1 System Previous Status 


The system indicates whether or not a System Dump is available as a result of the 
previous session. 
1. Ifno dump is available the message issued is: 

IL28 NO PREVIOUS DUMP 


2. Ifa dump does exist the message is: 


SYSTEM PREVIOUS STATUS ON mm/dd/yy AT hh:mm:ss 


followed by one the following: 


- SYSTEM EXCEPTION } 
} ON J = xx P = xx CLASS = xx TYPE = xx 
- HARDWARE FAILURE } 


- CALL TO PANIC FROM J = xx P = xx CODE = xxxx 
- CHANNEL EXCEPTION ON MCxx PC = xx LC = xx 
- UNKNOWN 
- SYSTEM RESTART 
3. Ifthe last GCOS 7 session was terminated through the 


TERMINATE SYSTEM command, the message is: 
SYSTEM PREVIOUS STATUS ON mm/dd/yy AT hh:mm:ss 


SHUTDOWN 


4. Ifthe last GCOS 7 session was terminated when the back-up battery had 
failed or was discharged, no dump is available and this message is displayed: 


SYSTEM PREVIOUS STATUS ON mm/dd/yy AT hh:mm:ss 
EMERGENCY SHUT DOWN 


5. Inall cases the system then asks the question * ILO1 OPTIONS ? in order to 
determine what work is required. 


NoTE: 
A System Dump, when present, must be processed by a Dump Session during 
the subsequent automatic loading, either to be printed or stored on disk. This is 
necessary because when the dump is taken, only some segments in memory are 
stored. Other segments are dumped either from memory or backing store and 
are modified by the new session. If the system previous status was 
SHUTDOWN or EMERGENCY SHUT DOWN, no dump is available because 
the dump area contains no valid information. Any attempt to perform a dump 
session is rejected. 
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3.4.2 IL01 Options 


NoTE: 
Examples of answers to ILO1 OPTIONS question are given in Section 3.4.7 
Example of Answer to the ILO1 OPTIONS ? Question. 


The answer given to the ILO1 question directs the remaining loading operations. 
This answer can consist of several elements chosen by the operator, depending 
upon the following: 


e Whether or not a Dump session should be performed. 


A dump session is needed if the previous session terminated abnormally and if a 
dump is available. A dump session allows the dump to be printed on the line 
printer, displayed at the operator console, or saved on a disk for later processing. 
At the end of the Dump Session, the ILO1 question is displayed again. 


e Whether or not a Restore Session is needed. 


e Whether or not a Cold Restart or a Clean Restart should be performed. 
The default option - a Warm Restart - is the usual case; sometimes a Cold 
Restart and, in rare circumstances, a Clean Restart is required. 


e Whether or not MAM (Message Access Method) is to be included as parameter 
in the answer to the ILO1 question to define handling of telecommunication 
message queues. 


The answer to Question ILO1 can also establish the status of the session by 
indicating or modifying the following: 


the list of resident disks 

the list of backing store disks 

the list of shared disks (coupled systems) 

the behavior of the system for the next storage load 

the behavior of the system for the next system interruption. 


After normal shutdown, the operator simply presses the EXECUTE (or 
TRANSMIT) key to perform a Warm Restart. The date and time are current; the 
list of resident, backing store or shared disks is unchanged, unless message IL16 
has been displayed before the ILO1 question. 
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3.4.3 Answering the IL01 Question 


After indicating the system previous status, the system asks the question: 
* ILO1 OPTIONS ? 


and the operator replies with one or more commands from the list shown in the 
following two pages. This answer directs the remaining loading operations and 
specifies the type, status and characteristics of the session. These commands are 
described in detail in the following Sections. 


NOTES: 


1. The maximum length of element lists (elements between left and right 
parentheses) is 255 characters. 


2. The separator of elements inside element lists is the comma, except for the 
DUMP_CD command where a semi-colon is used instead. 


3. The separator of the ISL options defined by the various following key 
words may be a comma, semi-colon or blank. 


[{BKST(/[,volnml, ... , volnm15]) }] 
{DATE (mm.dd.yy/hh.mm. [ss] ) }] 
{ [ {* }] }] 
{ [ {BANNER} ] }] 
[ {DISPLAY [ ({STATUS}) ] }] 
[{ [ {TIME } ] }] 
[{ [ {OPTION} ] }] 
{DISK([libnm..]member-name[:volnm] ...) }] 
{ [ {CONS} ] }] 
{DUMP [ ( )] ] 
] 


oe 
{ [ {DISK} 


{DUMP_CD( IL03 response ; [ IL03 response ;] ...) }] 


{ {0 


[{ {CONS } } 
[ {HELP ({ }) }] 
[{ ? {PRINTER} } 
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{ [ {NAUTO} {NSILENT} ] }] 
{INIT [ ({ hat }] }] 
[{ [ {auTo } {SILENT } ] }] 
[{LIB(volnmo [ ,volnm1, ...volnm15]) }] 
[{ [ {YES }] }] 
[ {MAM [ ({REFORMAT}) ] }] 
[{ [ {No } }] 
[{NSYSSTUP }] 
[{ [{al, } T-f{e}1 4 }] 
[{ PAGESIZE [ ({ } t*{ }1)] }] 
{ [ {n{.m]} [ {8}] ] } 
{PVMF (volnm0[,volnml1, ...volnm15] ) }] 
{LIB[, PVMF] } }] 
{ REFORMAT ({ }) }] 
{ {PVMF [, LIB] } }] 
{ {OFF} }] 
{REPEAT({  }) } 
{ {mm } }] 
{RESIDENT (volnm1[,volnm2, ...volnm10] ) }] 
[{ {WARM } } 
[{RESTART ({COLD }) }] 
[{ { CLEAN } } 
[ {RESTORE [ (parameter-list) ] }] 
[{SHARED(volnm1, volnm2,...volnm36) }] 
[{SHARED2 (volnm37,... volnm72) }] 
[{SHARED3 (volnm73,... volnm108) }] 
[{SHARED4 (volnm109,... volnm144) }] 
[{SHAREDS5 (volnm145,... volnm180) }] 
[{SHARED6 (volnm181,... volnm200) }] 
{SPOOL (max, cache-option, cache size, domain1, }] 
{ [ ...domain20 ] ) }] 
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3.4.3.1 


3-18 


BKST 


{ {WARM  } }] 
{SYSQM({CLEAN }) }] 
{ { BACKUP } }] 
{ {+} } 
[{TIMEDEV({ } hh [.mm]) } 
[{ 1) } 
{ {ON } } 
[{TRc({ —}) } 
[{ {OFF} } 
[{TVMF(volnm0[,volnml, ...volnm15]) }] 
BKST(/ [,volnml1,volnm2,..... volnm15] ) 


This option specifies the disk volumes which contain the temporary backing store 
files SYS.BKST, SYS.BKST1 up to SYS.BKST15. The first volume specified is 
the system disk which contains SYS.BKST, the second volume contains 
SYS.BKST1, the third contains SYS.BKST2 and so on up to SYS.BKST15. The 
slash "/" must be used instead of volume name to specify the system disk. The 
SYS.BKST should be on the system disk. If the first media name is not the system 
disk ("/"), the following message is displayed: 


VM04 FATAL: ONLY / IS ALLOWED AS A MEDIA FOR SYSTEM BACKING STORE 


The system then enters an endless loop. A new storage load must be performed and 
the operator must enter / to specify the volume name of SYS.BKST file. 


The file SYS.BKST is a mandatory file. A session cannot take place without it. The 
absence or the error in opening this file causes the following message to be 
displayed. 


vMO6 FATAL: IT HAS BEEN IMPOSSIBLE TO OPEN SYSTEM BACKING STORE 
The system then enters an endless loop. A new storage load must be performed. 


Any volume name between volnm! to volnm15 can be omitted indicating that the 
corresponding backing store file does not exist or is not to be used. 


NOTE: 
When a volume is removed, the commas must remain. 
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The list of volumes is used during the initial checking of device states and is 
retained from session to session even if, in the mean time, the system has been 
powered off. The command needs to be specified only during the first storage load 
following the creation of a new system disk or when it is required to change the list 
of backing store volumes. 


The backing store volumes must be online and in READY state when the load is 
performed, otherwise the following messages are displayed: 


IL61 MEDIA NAME NOT AVAILABLE FOR FILENAME 
IL62 GIVE MEDIA NAME OR REPLY CR 


The operator must enter the name of the volume where the given file is allocated. 


The absence or an error in opening non mandatory files, 1.e., SYS.BKST1, 
SYS.BKST2, ...... , SYS.BKST15 produces the following warning message. 


VMO8 WARNING : THE sys.bksti HAS NOT BEEN OPENED 
and the corresponding backing store file is not used for the session. 
If the BKST contains only one file, the following message is displayed: 


VM09 WARNING : NO OTHER PAGING BACKING STORE THAN THE SYSTEM 
BACKING STORE IS ACTIVE 


Disk mirroring is not supported on BKST volumes. If a MIRROR disk is declared 
in the BKST option, it is rejected with the message: 


IL80 volnm: DEVICE MIRROR FORBIDDEN UNTIL END OF 
INITIALIZATION 


The concerned BKST file is ignored, message IL61 is sent to the operator console, 
and question IL62 must be answered. Refer to the Mirror Disks User's Guide for 
further details. 


If all the BKST files are inactive, the following message is displayed: 
VM10 FATAL: AT LEAST ONE BKST FILE IS COMPULSORY 


The system then enters an endless loop. A new storage load must be performed. An 
error while loading or unloading the system structures produces one of the 
following messages: 


VMO1 FATAL: ERROR WHILE LOADING A SEGMENT FROM THE SYSTEM BACKING 
STORE 


VM02 FATAL: ERROR WHILE WRITING BACK A SEGMENT IN THE SYSTEM 
BACKING STORE 


The system then enters an endless loop. A new storage load must be performed. 
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However, it may be necessary to reformat the system disk depending on the 
Input/Output completion code. (Refer to Section 3.4.3.22 RESTORE). 


The backing store volumes, other than the volume supporting the SYS.BKST file, 
are not normally resident. Those which are required to be resident must be declared 
in the RESIDENT option. 


All disks declared in the BKST option have the BKST attribute (as returned by the 
DHW operator command), except for the system disk (containing the SYS.BKST 
file), which has the SYSTEM attribute. 


3.4.3.2 DATE 


DATE (mm.dd.yy/hh.mm[.ss] ) 


IMPORTANT: 
This command should be used only in very exceptional circumstances, for 
example if the Service Processor TIME-OF-DAY device (DPS 7000) is not 
working. 


Js) 


When absolutely essential this option can be used to set the reference date and 
time of the GCOS 7 session, where mm.dd.yy are numerical representations of the 
month, day and year and hh.mm.ss the time of day in hours, minutes and seconds. 
The values may be entered as one or two digits as appropriate. The reference date 
and time entered with the DATE option are used only for the current session and 
are not retained from session to session. 


At the next reload of GCOS 7, the reference time is taken from the Service 
Processor. The local time is then calculated by the algebraic addition of the 
reference time to the time deviation value set with the TIMEDEV option. 


If an invalid date is given the following message appears: 
IL44 DAY/TIME M.D.Y/H.M [.S] ? 


and the operator must reply with a valid date and time, for example: 


I: 06.30.88/14.23.30 
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Then the system compares the local date and time resulting from the new reference 
time entered by the operator with the previous status date and time. If the current 
local date and time is lower, the following messages are displayed: 


>>> PREVIOUS LOCAL DATE : hh:mm:ss MMM dd, yyyy TIMEDEV = shh:mm 


>>> CURRENT LOCAL DATE : hh:mm:ss MMM dd, yyyy TIMEDEV = shh:mm 
IL70 SYSTEM WILL BE FROZEN 
IL70 DO YOU AGREE (Y OR N) ? 


s is either - or + . When the time deviation value has been modified the character 
string "NEW TIMEDEV" is used instead "TIMEDEV" in the "CURRENT LOCAL 
DATE" message. 


The answer Y (yes) indicates that the operator agrees not to have the local time set 
back (an After Journal exists on the site): the system will be frozen until the 
current local time passes the previous status local time. The answer Y is forced in 
AUTO mode. 


When the answer is not equal to Y (yes) the ILO1 OPTIONS question is asked 
again in order to update the date or time deviation values or to continue the 
processing by pressing "Enter". 


DISK([libnm..] member-name [ :volnm] ) 


This option can only be used alone. It specifies that all the answers to the ILO1 
OPTIONS? question are in the named source library member. Default values are 
SYS.HSLLIB as the source library, and the system disk as the volume. After this 
answer, in the current session, answers to the ILO1 question are read from the 
named source library member. 


When the member addressed by the DISK option contains an erroneous option, a 
syntax error message is displayed and the ILO1 OPTIONS question is sent again to 
the operator. 


When a library member is given, it is retained from session to session. 
Consequently, when the AUTO mode is used sometime later, this library must 
contain the RELOAD _ OPTIONS or INIT_OPTIONS and H_SYS_ REPLY 


members. 
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3.4.3.4 DISPLAY 


B 
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[ 


[ 


The operator should use this option to display the following: 


* The star (default value) means the following ILO1 
options are displayed: BKST, DISK, DUMP, 
DUMP _CD, HA, INIT, LIB, MAM, PAGESIZE, 
PVMF, REPEAT, RESIDENT, RESTART, RESTORE, 
SHARED, SHARED2, SHARED3, SHARED4, 
SHAREDS, SHARED6, SPOOL, TIMEDEV, TRC, 


TVMF. 
BANNER The ISL banner is displayed. 
STATUS The system previous status is displayed. 
TIME The current local time is displayed. 
option Displays the value of any other ILO1 option. 


The * ILO1 OPTIONS? question is asked again after the display. 


The list of resident or shared disks displayed is from the previous ISL, it does not 
take into account any modifications that may have been made during previous 
GCOS 7 sessions. 


This option cannot be used when stored in a library member. 


IMPORTANT: 
Use the DISPLAY (TIME) option to display the current local date, time and 
time deviation values. However, (DATE) and DISPLAY (TIMEDEV) give the 
last values entered under the DATE and TIMEDEV options of the IL01 
question. These could be very old. 
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3.4.3.5 DUMP 


This option allows the operator either to print/display the dump left at the end of 
the previous session or to store it on disk (in the SYS.SYSDUMFP file) to be 
subsequently printed or interactively analyzed by the DPAN utility. 


IMPORTANT: 
If a dump is not processed by a dump session during GCOS 7 loading, it will be 
corrupted by the current session, overwriting main memory and the backing 
store where most of the dump information is found. 


J) 


The dump session dialog may be entered: 


e from the console. This is done by answering question ILO1 with the command: 
DUMP or DUMP(CONS). 


e from disk. This is done by answering question ILO1 with the command: 
DUMP(DISK) 


If the DUMP command is issued, but no dump is available (e.g. there has been a 
normal termination of the last GCOS 7 session), the following message is 
displayed: 


IL28 NO PREVIOUS DUMP 


In this case, the dump session is terminated and the ILO1 question is displayed 
again. 
1. DUMP or DUMP(CONS) 


If a dump is available from the previous GCOS 7 session, then the following 
question is asked: 


IL03 DUMP? 


The operator answers this question with one function at a time and the 
question is repeated until the dump session ends. Termination is done by 
entering END and pressing the EXECUTE or TRANSMIT key. 
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NOTE: 


By using the HELP directive with IL03, you can obtain the syntax of all the 
DUMP commands. 


To send a summary of the dump to the line printer, enter M in reply to the IL03 
question and comments in reply to the IL14 message, but see Note below. 


* TLO3 DUMP? M 
* TL14 CRASH COMMENTS? 


I: (Enter your comments.) 
* TLO3 DUMP? 


where M indicates that a mini dump (Mini Memory) is to be sent to the line 
printer 


NOTE: 


This facility should be used only as a last resort, if GCOS 7 cannot otherwise be 
restarted. 


*IL14 CRASH COMMENTS gives the operator an opportunity to give any 
useful comments on the first page of the dump printout. (If more than one line 
of comments are to be given, each line must be terminated by a hyphen.). 


The characteristics of the paper dimensions are taken from the ISL option, 
PAGESIZE. 


To store a standard dump on disk, the following must be entered: 


*TL03 DUMP? O, [efn:] volnm, DEF 
*TLO3 DUMP? EXEC,DPS STD 


where efn is the external file name (default is SYSSSYSDUMP), and volnm is 
the volume name of the disk which holds the SYS.SYSDUMFP file. If it is the 
System disk, volnm can be replaced by "/". Note that the O (Outfile) in the 
operator reply is alphabetic. 


The SYS.SYSDUMFP file can be put on any disk. The dump overwrites any 
previously stored dump on the SYS.SYSDUMF file, as only one dump at a time 
may be written to this file. 


Thus if this file already holds a dump from a previous session, which must be 
kept or which has not been printed, and a new dump occurs, the new dump must 
be printed (using the M function previously described to send it to the line 
printer). One alternative is to use another disk to hold the SYS.SYSDUMFP file, 
if one is available. Another alternative is to use a different file on the same disk. 
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It is also possible to use a self defined dump procedure using 
"EXEC_LIB,library-name:volnm" and "EXEC,member-name" as answers to 
the ILO3 DUMP? question. 


To change the default library name, the following can be entered: 
*IL03 DUMP? EXEC LIB, libnm : volnm 


EXEC_LIB defines the source library (libnm) to be opened for access to the 
subfiles named in subsequent EXEC commands. The default libnm is 
SYS.HSLLIB. 


The EXEC command starts the execution of the dump commands as read from 
the named subfile. DPS STD is the standard dump sequence source file. The 
ILO1 question is reissued after dump commands, except in Auto Mode. 


DUMP (DISK) 
In this case, the answers to the ILO3 question are entered from disk. 


The answers must have been written previously on disk by answering 
question ILO1 with DUMP_CD option (see Section 3.4.3.6 DUMP_CD, 
below). 


The DPAN Utility 


DPAN is a dump analyzer running under GCOS 7 which provides the operator 
with: 


— adump saving facility on tape (DP_SAVE) 
— a dump printing facility (DP_PRINT). 
See Appendix B Calling Systems Utilities for a detailed description. 
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SYNOPSIS OF FUNCTIONS RELATED TO DUMP 


SYSTEM PREVIOUS STATUS ON ... 
*ILO1 OPTIONS ? DUMP_CD ( [A] answer IL03....) 


a Ta > 


IL01 Se 
_ | IL03 answer | 


*ILO1 OPTIONS ? DUMP (DISK) , 


IL01 


*ILO1 OPTIONS ? DUMP 


DUMP (CONS) —_ 
ILO3 DUMP ? 
ae es 
Kk oS 
In2S WARNING M 0, [efn:] volnm,DEF 
NO PREVIOUS DUMP IL14 CRASH COMMENTS ? EXEC,DPS_STD 
y I: 
ILot 

SYS. 
\ SYSDUMP 

Vv Vv 

IL03 IL03 

v v 

ILo1 ILO1 
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3.4.3.6 DUMP_CD 


[ {A} ] 
DUMP_CD([ ];ILO3 answer; [ILO3 answer;]...) 
[ {APPEND } ] 


This option is used to record on disk the answers to the IL03 DUMP question 
(DUMP session). These recorded answers will be used when answering 
DUMP(DISK) to the ILO1 question (refer to Section 3.4.3.5 DUMP). 


When A or APPEND is used, the answers are appended to those already existing. 


If the last recorded answer is not "END", the IL03 question is displayed again at 
the console when DUMP(DISK) is used. 


NOTE: 
This option does not create a library member. Consequently, it is not possible to 
update the DUMP_CD information with the maintain library processor. 


3.4.3.7 HA (High Availability) 


e) 


{ 
HA ({ 
{ 


This option is for management of the High Availability product. When ON is 
entered, the Complex Management Service (CMSC) is started at GCOS 7 
initialization. The default is ON. 
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3.4.3.8 HELP (or ?) 


3.4.3.9 
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INIT 


HELP (or ?) 


This option (when typed first as a reply to the ILO1 or the IL03 question) displays a 
HELP text with all possible replies to the *ILO1 OPTIONS? and *IL03 DUMP? 
questions on a main console. 


When the HELP text to the *ILO3 DUMP? question is displayed, the directive 
MORE (Y/N) 


appears. If "Y" is entered, additional HELP text will be displayed. If "N" is 
entered, the display terminates. 


The HELP text may be directed to the line printer by using the form: 
HELP (PRINTER) 
The *ILO1 OPTIONS? question is then displayed again. 


This option cannot be used on a library member. 


[ {NAUTO} {NSILENT}  ] 
INIT[( { } { })] 
[ {AUTO } {SILENT } ] 


This option specifies the processing of the next, and subsequent GCOS 7 
initializations. When the AUTO parameter is entered, the next GCOS 7 
initialization automatically uses the ISL options stored on disk. 


These options are stored in two members of the SYS.HSLLIB library, or two 
members of the library specified by the DISK option. Depending on whether or not 
there has been a firmware reinitialization, the options are read from different 
library members: 


e When the GCOS 7 reload is preceded by a firmware reinitialization, the options 
are read from the INIT_OPTIONS member. 


e When there is no firmware reinitialization preceding the GCOS 7 reload, the 
options are read from the RELOAD OPTIONS member. 
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For the DPS 7000, the mode of the first initialization (e.g. after power up) is 
determined by the value of the Service Processor initialization parameter: 
AUTOmatic or MANUAL. Subsequent reloads are automatic if the AUTO 
parameter is selected for the INIT option. 


In AUTO mode the IL14 CRASH COMMENTS? question is automatically 
answered by the string "AUTO". If the SILENT parameter is also selected, no 
messages are issued to a main console during the next GCOS 7 initialization until 
device-testing time (see Section 3.4.4 Date and Time Management). This parameter 
is valid only if the AUTO parameter is also specified. 


LIB(volnmo [,volnml,..... volnmi5] ) 


This command specifies the disk volumes which are to contain the backing store 
files for permanent information, SYS.LIB, SYS.LIB1 up to SYS.LIB15. 


The first volume specified is the disk which contains SYS.LIB, the second volume 
contains SYS.LIB1, the third contains SYS.LIB2 and so on up to SYS.LIB15. The 
slash "/" may be used instead of volume name to specify the system disk. Any 
volume name between volnm1 to volnm15 can be omitted indicating that the 
corresponding permanent backing store file does not exist. 


The list of volumes is used during the initial checking of device states and is 
retained from session to session even if, in the mean time, the system has been 
powered off. The command needs be specified only during the first storage load 
following the creation of a new system disk or when it is required to change the list 
of backing store volumes. 


The volumes supporting a SYS.LIBi file must be online and in the READY state 
when the load is performed, otherwise the following messages are displayed: 


IL61 MEDIA NAME NOT AVAILABLE FOR FILENAME 
IL62 GIVE MEDIA NAME OR REPLY CR 


The operator must enter the volume name of SYS.LIBi file. 


The SYS.LIB is a mandatory file. A session cannot take place without it. An error 
in opening this file causes the following message to be displayed. 


VM0O7 FATAL: THE SYS LIB IS MANDATORY AND IT HAS NOT BEEN POSSIBLE 
TO OPEN IT 


The system then enters an endless loop. A new storage load must be performed. 
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The absence or an error in opening of non mandatory files, i.e. .LIB1, SYS.LIB2, 
eee, »SYS.LIB15 causes the following warning message: 


vMO8 WARNING: THE sys.libi HAS NOT BEEN OPENED 
and the corresponding backing store file is not used for the session. 
If all the LIB files are inactive, then the following message is displayed: 


VM10 FATAL: AT LEAST ONE LIB FILE IS COMPULSORY 


The system then enters an endless loop. A new storage load must be performed and 
the operator must specify the disk volumes which contain the backing store files 
for permanent information. At least the SYS.LIB file is mandatory. 


Because of the information in SYS.LIBi files - sharable modules, pre-initialized 
load modules, checkpoints - during RESTART COLD or WARM, the configuration 
of these files must not be changed. If the media names are not the same as that of 
the previous session, the following message is displayed: 


VM0O5 FATAL: NEW MEDIAS HAVE BEEN SPECIFIED FOR THE PERMANENT BKSTS 
DURING A WARM OR COLD RESTART 


The system then enters an endless loop. A new storage load must be performed. 


Also, during a cold or warm restart, if there is a mismatch between the 
characteristics of SYS.LIB files for the current and previous sessions, the system 
crashes at GCOS 7 initialization. For example, if the file size has been modified. 


Concerning these last two situations, the operator must do one of the following: 
e To change a SYS.LIBi file, perform a new storage load specifying a clean 
restart. In this case, pre-initialized load modules and sharable modules are lost. 


e To use the SYS.LIBi files from the previous session, re-enter the LIB parameters 
specifying the old volume names. 


All disks declared in the LIB option have the BKST attribute (as returned by the 
DHW operator command), except for the system disk (if present in the list), which 
has the SYSTEM attribute. 


The disks declared in the LIB option are not normally resident (except for the 
system disk, if relevant). Those which are required to be resident must be declared 
in the RESIDENT option. 


Disk mirroring is not supported on BKST disks. If a MIRROR disk is declared in 
the LIB option, it is rejected with the message IL80 (refer to "BKST" above). 
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3.4.3.11 MAM 
[ {YES } oo] 
MAM[({REFORMAT} ) ] 
[ {No | ee 


This option processes telecommunication message queues. The parameters are 
described below. 


YES This parameter causes all queues to be left as they 
were. A roll back of queues assigned to each job is 
requested. (See "File Salvager" under WARM 
RESTART, below.) 


This is only possible if the RESTART(WARM) option 
is also specified. 


REFORMAT All queues are cleared. All messages are erased. 


NO No telecommunication job can be executed until the 
network is generated again. 


3.4.3.12 NSYSSTUP 


With this option, GCOS 7 can be started without executing System Startup 
(SYSTEM member in the SITE.STARTUP library). 


3.4.3.13 PAGESIZE 


} { 
[ {n[.m]} [ {8 


This option sets the characteristics of the paper dimensions where "n.m" represents 
the height of the paper in inches and the other parameter is the print density in lines 
per inch. The defaults are 11 and 6 respectively. 
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3.4.3.14 PVMF 
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PVMF(volnm0O [,volnml,..... volnmi5] ) 


This option specifies the disk volumes which contain the permanent VMF backing 
store files SYS.PVMF, SYS.PVMF1 up to SYS.PVMF15. The first volume 
specified is the disk which contains SYS.PVMF, the second volume contains 
SYS.PVMFI1, the third contains SYS.PVMF2 and so on up to SYS.PVMF1S5. 


The slash '/' may be used instead of volume name to specify the system disk. Any 
volume name between volnm1 to volnm15 can be omitted indicating that the 
corresponding permanent backing store file does not exist. 


NOTE: 
When a volume is removed, the commas must remain. 


The list of volumes is used during the initial checking of device states and is 
retained from session to session even if, in the mean time, the system has been 
powered off. The command needs be specified only during the first storage load 
following the creation of a new system disk or when it is required to change the list 
of backing store volumes. 


The Backing Store volumes must be online and in the READY state when the load 
is performed, otherwise the following messages are displayed: 


IL61 MEDIA NAME NOT AVAILABLE FOR FILENAME 
IL62 GIVE MEDIA NAME OR REPLY CR 


The operator must enter the volume name of SYS.PVMFi file. 


The file SYS.PVMF is a mandatory file, a session cannot take place without it. The 
absence or an error in opening this file causes the following message to be 
displayed: 


VM0O7 FATAL: THE SYS.PVMF IS MANDATORY AND IT HAS NOT BEEN 
POSSIBLE TO OPEN IT 


The system then enters an endless loop and a new storage load must be performed. 


The absence or an error in opening of non mandatory files, 1.e.SYS.PVMF1, 
SYS.PVMF2, ....... »S YS.PVMF15 causes the following warning message: 


VMO8 WARNING : THE SYS.PVMFi HAS NOT BEEN OPENED 
and the corresponding backing store file is not used for the session. 
If all the PVMF files are inactive, then the following message is displayed. 


VM10 FATAL: AT LEAST ONE PVMF FILE IS COMPULSORY 
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The system then enters an endless loop. A new storage load must be performed and 
the operator must specify the disk volumes which contain the backing store files 
for permanent VMF files. 


During a cold or warm restart, if the media names are not the same as that of the 
previous session, the following message is displayed. 


VM05 FATAL: NEW MEDIAS HAVE BEEN SPECIFIED FOR THE PERMANENT BKSTS 
DURING A WARM OR COLD RESTART 


The system then enters an endless loop and a new storage load must be performed. 


Also, during a cold or warm restart, if there is a mismatch between the 
characteristics of the SYS.PVMF files for the current and previous sessions, then 
there is a system crash at GCOS 7 initialization (for example, modification of file 
size). 


Concerning these last two situations, the operator must do one of the following: 


e To change a SYS.PVMFi file, perform a new storage load specifying a clean 
restart. In this case, all permanent VMF files are lost. 


e To use the SYS.PVMFi files from the previous session, re-enter the PVMF 
parameters specifying the old volume names. 


All disks declared in the PVMF option have the BKST attribute (as returned by the 
DHW operator command), except for the system disk (if present in the list), which 
has the SYSTEM attribute. 


The disks declared in the PVMF option are not normally resident (except for the 
system disk, if relevant). Those which are required to be resident must be declared 
in the RESIDENT option. 


Disk mirroring is not supported on BKST disks. If a MIRROR disk is declared in 
the PVMF option, it is rejected with the message IL80 (refer to "BKST" above). 
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3.4.3.15 REFORMAT 


{LIB [,PVMF] } 
REFORMAT ( { }) 
{PVMF [,LIB] } 


This option is used to reformat the permanent backing store. The valid parameters 
are LIB and PVMF. This option forces a clean restart of GCOS 7 (permanent 
information is lost) even if RESTART(CLEAN) is not explicitly specified in the 
answer to ILO1 OPTIONS question. 


In case of an invalid parameter the following message is displayed: 
VM03 ILLEGAL SYNTAX OF BACKING STORE COMMANDS 


The system then enters an endless loop. A new storage load must be performed. 


3.4.3.16 REPEAT 


This option specifies the processing of the next GCOS 7 interruption and the 
subsequent ones triggered either by the TERMINATE SYSTEM command or by a 
crash. 


When the parameter OFF is entered, the system is stopped after GCOS 7 
interruption. 


When mm (minimum time in minutes between two consecutive GCOS 7 
interruptions by crash) is entered, GCOS 7 is automatically reloaded after its 
interruption. If this facility is used with the AUTO parameter of the INIT 
command, AUTO mode is stopped if two consecutive crashes occur inside the time 
specified by mm. 
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3.4.3.17 RESIDENT 
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RESIDENT ({volnml | /} [,volnm2,...]) 
This option specifies those disk volumes which are to be resident. 


A disk declared in the RESIDENT option has the RSDT attribute (as returned by 
the DHW operator command) and is allocated to X1 (system). Therefore is cannot 
be held nor put on STANDBY. RSDT volumes are used, by default, to allocate 
temporary files. 


The system disk need not be explicitly declared as resident. Although the RSDT 
attribute is not returned when the DHW command is issued on the system disk 
(only SYSTEM is displayed), the system disk is flagged as resident in the system 
tables; therefore it is taken into account for the allocation of temporary files. 


Although it is not necessary to specify the system disk in this list, it can be 
specified, if desired, by replacing volnm1 by / (a slash) in the list, for example: 


RESIDENT (/,HIT90, FSD15) 


The list of resident volumes is used during the initial checking of device states and 
is retained from session to session even if in the meantime, the system has been 
powered off. Therefore it need be specified only at the first storage load following 
the creation of a new system disk or when the list needs to be changed. 


The list of resident volumes; may be changed safely only during a cold or clean 
restart or during a warm restart where the previous session was terminated by a 
TERMINATE SYSTEM command. If a warm restart is being performed after the 
abnormal termination of the previous session, avoid making changes to the list 
especially if the volumes to be changed contain files which were busy when the 
termination occurred. 


Given that the list of resident volumes can be modified only at a restart and that 
most of the OLTD cannot take place on a device that supports a resident disk (since 
they run on out devices), the number of resident volumes should be kept to a strict 
minimum. In general, resident volumes should only contain permanent system files 
and temporary files; consequently, the frequently accessed user files should be 
cataloged and localized on non-resident volumes. 


Error Detection 


e The maximum number of resident volumes is 10. If more than 10 resident 
volumes are declared, the following message is displayed: 


DV37 GCOS: NUMBER OF RESIDENT EXCEEDS 10, NEW LIST IS REQUIRED 


and the DV43 question ("REPLACE BY") must be answered (see Section 
3.4.5.2 DV43 Question below). 
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e Disk mirroring is not supported on resident volumes. If a MIRROR disk is 
declared in the RESIDENT option, it is rejected as follows: 
DV38 DECLARED <RESIDENT> LIST: 
<volnml> <volnm2>... 


DVO5 RESIDENT MIRROR FORBIDDEN: 
<volnmi> <volnmj>... 


and the DV43 question must be answered (see Section 3.4.5.2 DV43 Question 
below). 


Refer to the Mirror Disks User's Guide for further details. 


e Ifa declared resident disk has not been found by the system, e.g. because the 
disk drive is STANDBY or because the volume name was erroneous in the 
RESIDENT option, the operator is notified as follows: 


DV38 DECLARED <RESIDENT> LIST: 
<volnml> <volnm2>... 
DV40 RESIDENT NOT FOUND: 
<volnmi> <volnmj>... 
and the DV43 question must be answered (see Section 3.4.5.2 DV43 Question 
below). 


Note that the new list of resident volumes (result of the answer to DV43 
question) keeps valid for all subsequent GCOS 7 sessions, until: 


— either a new list is specified using the RESIDENT option at ISL time, 


— ora RESTART (CLEAN) is performed. In this case, the VMF file in which 
the list was stored is lost, and the valid list is the list of volumes declared in 
the last RESIDENT option of ISL. 
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3.4.3.18 RESTART 


{WARM } 
RESTART ({COLD }) 
{ CLEAN} 


This option specifies how jobs, outputs, and system characteristics from the 
previous session are to be treated. The three types of restart are described 
separately. 


NOTE: 
The permanent Backing Store or the media cannot be changed with a WARM or 
a COLD Restart. The permanent Backing Store space, and the media specified 
and the number of media must be the same as in the preceding ISL. 


3.4.3.19 RESTART(WARM) 
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This is the default option and does not need to be specified. It restarts the session as 
near as possible to the state in which it terminated. All system characteristics set by 
operator action, i.e. the multiprogramming level, job-class characteristics, are left 
unaltered. The events which occur vary depending on whether the previous session 
was terminated by the TERMINATE SYSTEM command or whether it terminated 
abnormally. (See Section 3.5, Zerminating the Session). 


Warm Restart After a Normal Shutdown 


1. All jobs and outputs are restored to the state they were in at the end of the 
previous session. Apart from the fact that the Output Writer, FEPS, 
GTWRITER, IOF, and RBF service jobs need to be started again, everything 
is exactly as it was before the shutdown. 


2. One of the following messages is displayed for each job which was executing 
or in suspended state at shutdown time: 


RSO6 ron REACTIVATED 
RRO5 ron.ssn REMAINS SUSPENDED 


The GCL commands DISPLAY OUTPUT (DO) and DISPLAY LOAD 
(DLD) may be used to check job outputs. 
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Warm Restart After an Abnormal Termination 


1. The File Salvager checks the state of all files which were being used. A user 
file is said to be stable if it was either not opened or opened only in input 
mode. If some are unstable, that is, opened and in output mode, salvager 
action is usually needed. The UFAS access method provides a built in 
salvager and there is no action by the operator. However, for VBO files using 
the older BFAS access method, this question is asked: 


*SVO5 GCOS: FILE SALVAGING? 


— Ifthe answer NO is entered, salvaging is not attempted and no further 
messages are displayed. 


— If the answer YES is entered, file salvaging is attempted and an SV09 
message is displayed for each file indicating its state. 


SV0O9 efn FILE 


VERIFIED 
RECOVERED 
UNSTABLE 
UNALLOCATED 


VTOC DAMAGED 


NON STANDARD 


VERIFIED } 
RECOVERED } 
UNSTABLE } 
UNALLOCATED } 
VTOC DAMAGED } 
NON STANDARD } 


= The file is stable. 


[onten Tantenanten anton ‘anton ‘ante’ 


= The file has been corrected and is stable. 
= The file cannot be corrected. 


= A space allocation was being performed at the time 
of the abnormal system termination and has not been 
completed. The file must be reallocated. 


= The VTOC (Volume Table Of Contents) of the disk 
is damaged and salvaging is not possible. Use the 
VOLCHECK utility to check the integrity of the disk. 


= the file (or the disk) is not a standard native type; no 
salvaging is possible. If the disk should be standard, 
then damage to the disk may have occurred; run the 
VOLCHECK utility. 


— Ifa disk containing one of the files is not ready, then the following question 


is asked: 


*SVO7 GCOS: MOUNT volnm? 


Te 


To salvage the file, mount the disk and reply YES. To bypass file salvaging, 


reply NO. 
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2. All jobs which were not in the executing state are unmodified. 


RRO5 ron.ssn REMAINS SUSPENDED 


— RSO5 or RRO6 messages as appropriate are displayed for jobs which were 
executing or suspended between steps. 


— For jobs which were suspended within a step when a crash occurred, the 
current step is aborted and the RRO1 question is asked: 


* RRO1 ron.ssn ABORTED 


im-name SEVn[=mmm] REPEAT [FROM CHKPT xx] ? 


[Status] RC = ccccececee --> siu, return code 


* RRO1 ron.ssn ABORTED 


im-name SEVn[=mmm] REPEAT WHOLE JOB? 


[Status] RC = ccccccce --> siu, return code 


A SEV code is the severity of the step termination. This is usually SEV6 
indicating a system crash. For the other possible severity codes (SEV), refer to 
the JOF Terminal User's Reference Manual. 


The first RRO1 question - 


* RRO1 ron.step ABORTED lm-name SEVn[=mmm] REPEAT [FROM CHKPT xx] ? 


is issued if the executing step has been declared as being repeatable by the 
user. If no checkpoint (CHKPT) is specified, the beginning of the job step is 


used as the checkpoint 


value. The second RRO1 question - 


* RRO1 ron.step ABORTED lm-name SEVn[=mmm] REPEAT WHOLE JOB? 


is issued if the step is not repeatable but the job was declared as repeatable by 


the user. 


NOTE: 


The ROLLBACK? question is no longer asked. Now, if a Before Journal is 
used, Rollback is always automatically performed. Even if the output has been 
partly or totally printed, it is rebuilt, re-enqueued, and printed again from the 


beginning. 
The possible answers are as 


YES 


NO 


follows: 


The step executes from checkpoint xx; if no 
checkpoint was declared, the step restarts from the 
beginning. If the job was declared repeatable, the job 
restarts from the beginning. Any output from a part of 
the job which repeats is erased except the Job Report. 
In the case of the last RRO1 message, the file and 
communications queues are rolled back. 


The current step and job are aborted. If the step was 
under GAC (Generalized Access Control), the 
appropriate files are rolled back. 
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ALL 


HOLD 


Indicates that the answer YES is to be assumed for this 
and all subsequent RRO1 questions which will not then 
be asked. The salvage session proceeds. 


This is only a valid reply to the REPEAT WHOLE 
JOB? question. The job is put into the HOLD state and 
must subsequently be released before it can be 
executed. 


NOTES: 


1. 
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If the job was not executing a step, i.e., job or step initiation or termination 
was being performed, execution proceeds without the RRO1 question being 
asked. 


If the Before Journal was being used, ROLLBACK action is taken 
automatically. 


Outputs remain in the states they were in when the previous session 
terminated. For each output being printed when termination occurred, the 
following question is asked: 

*0U33 dvnm OUTPUT ron:ouseqnb RESTART FROM? 


The possible replies are the same as for question OU02 described in 
Section 5 Running User Jobs Under GCOS 7. 


A report is prepared, in output class A, which lists all the actions taken 
concerning files and jobs. 


The Output Writer, IOF, GTWRITER, and RBF service jobs are terminated 
and must be started again. 
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3.4.3.20 RESTART(COLD) 
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This 


option causes information left over from the previous session to be erased, and 


provides the operator with an empty system. It is used when it is not necessary to 
complete the jobs from the previous session or if a RESTART(WARM) has failed. 


The following sequence of events occurs: 


1. 
2. 


All existing jobs are lost. 


The operator either retains the contents of the SYS.OUT file or erases it, by 
replying to the following question: 

* QU16 SYS.OUT RECOVER? 

as 


If he replies YES, the SYS.OUT contents are retained and output requests are 
re-submitted with the same parameters as at output creation, but job reports 
and private output notifications are lost. If recovery is not possible, the 
following message is displayed: 


OU35 UNSUCCESSFUL SYS.OUT RECOVERY 
and the SYS.OUT contents are lost. 


If he replies NO the contents of SYS.OUT are erased and any file extents 
beyond its original allocation are deleted. 


NOTES: 


1. 


During a RESTART(COLD), outputs that were present when the system 
was stopped are rebuilt with the information known at the time of 
creation. Any modification done after creation (by HO, RO, or MO 
commands) is lost. 


The OU16 question is not asked if the SYS.OUT file is empty. 


If the answer to the OU16 question is YES, output classes are returned to 
their original class. 


The system multiprogramming level, job classes, job class characteristics, 
account information and Message Of Today (MOT) remain unaltered from 
the previous session. 


Pre-initialized Load Modules (PLMs) remain the same as for the previous 
session, provided that the SYS.LIB file has not been changed. 


Temporary files created on non-resident volumes during the previous 
session are not deleted. The VOLCHECK utility (VBO) or the 

DELETE TEMP command of the MAINTAIN VOLUME utility (FBO) 
must be run to do this. 


No report is prepared. 
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3.4.3.21 RESTART(CLEAN) 


The clean restart is most often useful to install GCOS 7, or to install a patch. It 
may also be used at other times when a cold or warm restart cannot be performed. 


So) 


IMPORTANT: 
This option has an extremely drastic effect, providing the operator with a 
completely empty system and erasing all information from the previous session. 
It is to be used with caution. 


The following events occur: 


1. 


SO. OO ON On 
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All existing jobs are lost. After a RESTART(CLEAN), outputs can be 
recovered, according to the answer given to the SYS.OUT RECOVER? 
question. 


All Pre-initialized Load Modules are cancelled. 
All accounting information is erased. 


All job classes except A..Z and RB are lost and all job class characteristics are 
reset to their default values. 


The multiprogramming level reverts to the value set at system configuration. 
The sharable module libraries are emptied, and must be reloaded. 

The network definition is deleted. 

No report is prepared. 


The internal job numbering system is reset (Run Occurrence Number is reset 
to 0001). 


Temporary files created on non-resident volumes during the previous session 
are not deleted. The VOLCHECK utility (VBO) or the DELETE _TEMP 
command of the MAINTAIN VOLUME utility (FBO) must be run to do this. 


Unless RESIDENT and SHARED options are used in the current restart, the 
lists of resident and shared disks are reset to those last specified by the ILO1 


options. Any modifications made since then are lost (because the lists are 
stored in a VMF file). 
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12. The operator either retains the contents of the SYS.OUT file or erases it, by 
replying to the following question: 
* QU1L6 SYS.OUT RECOVER? 
IT: 


If he replies YES, the SYS.OUT contents are retained and output requests are 
re-submitted with the same parameters, but job reports and private output 
notifications are lost. If recovery is not possible, the following message is 
displayed: 


0QU35 UNSUCCESSFUL SYS.OUT RECOVERY 
and the SYS.OUT contents are lost. 


If he replies NO, the contents of SYS.OUT are erased and any file extents 
beyond its original allocation are deleted. 


NOTES: 
1. The OU16 question is not asked if the SYS.OUT file is empty. 


2. Ifthe answer to the OU16 question is YES, output classes are returned to 
their original class. 


3.4.3.22 RESTORE 
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RESTORE [(system-file-description [,NCONFIG] [, FORMAT] ) ] 
where system-file-description has the following format: 
efn: {volnm| /} 


This option specifies that system segments, including system patches, can be 
restored from the SYS.SYSTEM file on the specified volume. The system file 
description is kept from session to session; it is established at initial system load. 
The parameters in the RESTORE option have the following meaning: 


SYSTEM FILE DESCRIPTION := { efn: {volnm} } 
{ Pe ad 
NCONFIG indicates that the original copy of system segments is 
restored. 
FORMAT indicates that SYS.BKST is to be formatted. This 


option must be specified when the file has been 
corrupted due to a physical Input/Output error. 


Note that the volnm can be replaced by a slash (/). 
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A restore session is usually performed by answering the ILO1 question during ISL 
and entering 


RESTORE (SYS .SYSTEM:volnm) 


The first time a restore is required, enter RESTORE; for subsequent restore 
sessions, answer RESTORE to the ILO1 question and press the EXECUTE key. 


If the SYS.SYSTEM file cannot be found on the disk specified, the following 
messages are displayed: 


IL38 SYS.SYSTEM NOT FOUND ONTO media name 


* TL63 GIVE <EFN:> MEDIA NAME OR REPLY CR 
Ls 


and the operator enters the correct <efn:>media name after the "I". 


In this case the correct<efn:>media is not kept and must be reintroduced the next 
time a RESTORE session is performed. 


A RESTORE results in all job classes except A..Z being lost. 


3.4.3.23 SHARED 


SHARED (volnm1, volnm2,... volnm36) 
SHARED2 (volnm37, ... volnm72) 
SHARED3 (volnm73, ... volnm108) 
SHARED4 (volnm109, ... volnm144) 
SHAREDS5 (volnm145, ... volnm18s0) 
SHARED6 (volnm181, ... volnm200) 


This option specifies which disk volumes are to be shared with another system. 
SHARED( ) or SHAREDi( ) specifies an empty list and erases the previous one. 
NOTE: One blank character is needed between left and right parentheses. 


The SHARED option is only valid for coupled systems. The management of 
coupled systems is explained in the Coupled Systems User's Guide. 


The list of sharable volumes is used during the initial checking of device states and 
is retained from session to session, even if in the meantime the system has been 
powered off. Therefore the parameter need be specified only at the first storage 
load following the creation of a new system disk or if it is required to change the 
list of shared volumes. 


The shared volumes are not normally resident. If they are required to be resident 
they must be declared as such by the RESIDENT option. 
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It is also possible to change the list of SHARED volumes during the GCOS 7 
session by using the MDHW command. 


Error Detection 


e The maximum number of shared volumes is 200. If more than 200 shared 
volumes are declared, the following message is displayed: 


DV66 THE LIMIT OF 200 SHARED DISKS HAS BEEN REACHED 


and the extra volumes are ignored. 


e Ifthe system disk, or a BKST disk (declared in BKST, PVMF, TVMF or LIB 
option), or the service disk (containing SPOS files, DPS7000/An only) is 
declared as a shared disk, then it is ignored and one of the following messages is 
displayed: 

DV31 GCOS: SHARED OPTION FOR volnm IS IGNORED: ALREADY DECLARED 
AS SYSTEM DISK OR BACKING STORE 


DV31 GCOS: SHARED OPTION FOR volnm IS IGNORED: SERVICE DISK 
CANNOT BE SHARED 


e The volumes specified in the list must be supported by suitable devices which 
have the dual sharing capability. If this is not the case, the following message is 
displayed: 

DV30 GCOS: DUAL SYSTEMS: ILLEGAL DEVICE FOR SHARED volnm 
NEW ISL MANDATORY 


and an endless loop is entered. The operator must perform a storage load again 
and correct the list of shared volumes at next ILO1 question. 


e Ifthe system has not been correctly configured for dual systems (DUALSYS 
statement of CONFIG), or if the Marketing Identifier for dual systems is not 
validated, the following message is displayed: 


DV27 GCOS: SITE NOT CONFIGURATED FOR DUAL SYSTEM USAGE. 
SHARED OPTION IS IGNORED 


and the SHARED option is ignored. 


e Ifa declared shared disk has not been found by the system, e.g. if its disk drive 
is in STANDBY, or if its volume name was erroneous when entering the 
SHARED option, or if the disk is seized by the other system, the operator is 
notified as follows: 


DV39 DECLARED <SHARED> LIST: 
<volnml> <volnm2>... 

DV41 SHARED NOT FOUND: 
<volnmi> <volnmj>... 
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3.4.3.24 SPOOL 
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and the DV43 question must be answered (see Section 3.4.5.2 DV43 Question 
below). 


The new list of shared volumes (result of the answer to DV43 question) stays 
valid for all subsequent GCOS 7 sessions, until: 


— either a new list is specified using the SHARED option at ISL time, 
— or the MDHW operator command is used to dynamically update the list, 


— ora restart (CLEAN) is performed. In this case, the VMF file in which the list 
was stored is lost, and the valid list is the list of volumes declared in the last 
SHARED (i) option of ISL. 


It is important to keep in mind that the list of shared volumes must be identical 
for each of the coupled systems. This is of basic importance when using 
mirrored disks (which may be declared as shared volumes). 


SPOOL (max, cache-option, cache-size, domainl [...domain20] ) 
This option is used to determine the following: 


e the number of available SYS.SPOOLi files, 
e GCL cache usage, 
e the list of GCL domains to be preinitialized from SYS.HBINLIB. 


This option enables system response time to be improved. 


Allocating a number of SYS.SPOOLi files enables sharing of GCL Input/Output 
over several files and thus speeds up response time. (See the Max parameter.) 


The use of GCL Cache enables a certain number of command definitions to be 
stored in memory. (This information is extracted from a BIN type library and 
temporarily stored ina SYS.SPOOLi file.) The result is a reduction in the number 
of I/Os ona SYS.SPOOLi file. (See the Cache Option and Cache Size 
parameters.) 


The use of pre-initialized domains enables the same command definitions to be 
shared by all system users, thus preventing congestion of the SYS.SPOOLi files 
and the GCL Cache. (See Domain parameter.) 


When the SPOOL option is specified, GCL batch jobs that are not entirely repeated 
from the beginning are aborted. If this occurs, an error message is sent to the main 
console. 
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Parameters 


max 


Cache-Option 


Starting and Terminating a GCOS 7 Session 


SYS.SPOOLi files can be numbered from 0 to 9 - 
SYS.SPOOLI, SYS.SPOOL2, ... SYS.SPOOL9. 
(0<=i<=9) 


The max parameter represents the maximum value for 
i when SYS.SPOOL files are allocated. For example if 
two SYS.SPOOL files are allocated, SYS.SPOOLO 
and SYS.SPOOL4, the value of max is 4. 


If the number of SYS.SPOOLi files is not known, then 
max should be given a value of 9, which is the default 
value. 


Values for i do not have to be consecutive, as GCL 
displays a message indicating which SYS.SPOOLi 
files are not available. 


If no SYS.SPOOL1 file can be accessed, GCL 
automatically allocates a temporary SYS.SPOOL file 
to enable the system to start. 


Question: How many SYS.SPOOLi files do you need? 


— in JOF or batch mode, you need 1 SPOOL per block 
of 10 users, with a maximum of 20 users per 
SPOOL. 


— for TDS, 1 SPOOL is sufficient. 


This parameter defines if and how GCL cache is to be 
used: 


0 =GCL Cache is not used. 
This value applies for TDS based operation. 


1 = GCL cache is used for commands applied to pre- 
initialized domains. 

This value applies if IOF is not often used and if users 
have defined only a few private commands. 


2 = GCL cache is used for all commands. 
You are advised to select this value if IOF is used 
intensively on your system. 


The default value for Cache-Option is 1. 
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Cache-Size 


domain | [...domain20] 


NOTE: 


This parameter helps to specify the size of GCL cache 
in memory. The value assigned to it gives the number 
of 64Kbyte segments to be reserved for cache. Each 
segment contains approximately 16 commands. The 
maximum value of this parameter is 8. 
(0<=cache-size<=8). 

The value you select depends on the use made of GCL. 


If cache-option=0, no segments need to be reserved 
and cache-size should be given the value 0. 


If cache-option=1, you need to reserve 2 to 4 
segments. 


If cache-option=2, you need to reserve 4 to 8 
segments, according to the number of IOF users. 
Reserve 8 segments if the number of IOF users could 
reach 40 or more. 


The default value for the Cache-Size parameter is 2. 


Names of GCL domains to be preinitialized; up to 20 
GCL domains can be preinitialized. Each domain name 
after the first in the command must be preceded by one 
or more spaces. 


Default = H_BREAK, IOF, H_ NOCTX, EDIT, MAIN 


I/O time is saved when frequently used GCL domains 
are preinitialized. 


Refer to the DISPLAY GCL CACHE command in Chapter 7 Description of 
the Operator Commands. 
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3.4.3.25 SYSQM 
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{WARM } 
SYSQM({CLEAN }) 
{BACKUP } 


The SYS.QM file (or its backup SYS.QM_ BACKUP) is a file through which the 
so-called permanent messages pass (Permanent messages include interactive 
answers given to commands, etc.). This ensures that the messages are memorized if 
they cannot be delivered; if the person who is due to receive the message is not 
logged on, for example. 


Three options exist. They are linked to the value of the RESTART parameter (see 
table below): 


e SYSQM (WARM) leaves the file as it is (in the case of aRESTART WARM). 


e SYSQM (CLEAN) clears the contents of the SYS.QM files, and starts logging 
messages on those same files again. 


e SYSQM (BACKUP) switches to using the SYS.QM BACKUP file for message 
logging. Use this option if SYS.QM is corrupted or cannot be accessed. 


RESTART 


SYSQM RESTART (WARM) RESTART (COLD) or 
RESTART (CLEAN) 


SYSQM (WARM) is the default] This combination is authorized, but 

option for RESTART (WARM).| it has the same effect as 

The contents of the files are SYSQM (CLEAN) 

unchanged 

SYSQM is cleared, despite the |SYSQM (CLEAN) is the default 

RESTART (WARM) option value for RESTART (COLD) or 
RESTART (CLEAN). Contents of 


SYS.QM and SYS.QM BACKUP 
are cleared. 


SYSQM Use this option if you cannot | Use this option if you cannot 
(BACKUP) | access the SYS.QM file. access the SYS.QM file. 
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3.4.3.26 TIMEDEV 
TIMEDEV({ + | - } hh [.mm] ) 


In normal circumstances the service processor clock provides a reference date and 
time (for example the universal time: UT) and a time deviation value, which may 
represent the local time zone, to get the local time used by GCOS 7. This option 
specifies the difference in hours (and minutes) between desired GCOS 7 local time 
and the reference time supplied by the Service Processor clock. The range of 
acceptable values is from -23.59 to +24.0. 

It is possible to modify the time deviation with the TIMEDEV option. 


After having entered the new time deviation value, the system checks the resulting 
local date and time. If this value is lower than the GCOS 7 time at the previous 
system termination the following messages are displayed: 


>>> PREVIOUS LOCAL DATE : hh:mm:ss MMM dd, yyyy TIMEDEV 
>>> CURRENT LOCAL DATE : hh:mm:ss MMM dd, yyyy TIMEDEV 
IL70 SYSTEM WILL BE FROZEN 
IL70 DO YOU AGREE (Y OR N) ? 


shh:mm 
shh:mm 


oll 


The s is either - or +. 


The answer Y (yes) indicates that the operator agrees not to have the local time set 
back (An After Journal exists on the site.): the system will be frozen until the 
current local time passes the previous local time. The answer Y is forced in AUTO 
mode. Any other answer implies that the current local date and time is acceptable 
for starting a new session. Then, one of the following messages is displayed: 


e no change of the time deviation value: 


>>> hh:mm:ss MMM dd, yyyy TIMEDEV = shh:mm (s is + or -) 


e the time deviation value has changed: 
>>> hh:mm:ss MMM dd, yyyy NEW TIMEDEV = shh:mm (s is + or -) 


This command, when accepted, updates the time deviation value in the Service 
Processor. 


NOTES: 
1. Itis preferable to use the MODIFY _TIME command under GCOS 7. 


2. As the TIMEDEV value can be modified while GCOS 7 is running, the 
DISPLAY (TIMEDEV) and DISPLAY (DATE) options may not give 
current TIMEDEV and DATE, but the last values entered under the DATE 
and TIMEDEV options entered as answers to the ILO1 question. These can 
be old. However, to get the current time, date and time deviation values the 
DISPLAY (TIME) option can be used, or the GCL command, 
DISPLAY _ TIME. 
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3.4.3.28 TVMF 
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This option activates the system trace function with the ON value and deactivates it 
with OFF. The default value is ON. 


TVMF(volnmo [,volnml,..... volnmi5] ) 


This command specifies the disk volumes which contain the temporary VMF 
backing store files SYS.TVMF, SYS.TVMF1 up to SYS.TVMF15. 


The first volume specified is the disk which contains SYS.TVMF, the second 
volume contains SYS.TVMF1, the third contains SYS.TVMF2 and so on up to 
SYS.TVMF15. The '" may be used instead of volume name to specify the system 
disk. Any volume name between volnm1 to volnm15 can be omitted indicating that 
the corresponding temporary backing store file does not exist. 


The list of volumes is used during the initial checking of device states and is 
retained from session to session even if, in the mean time, the system has been 
powered off. The command needs to be specified only during the first storage load 
following the creation of a new system disk or when the list of backing store 
volumes must be changed. 


The Backing store volumes must be on-line and in the READY state when the load 
is performed, otherwise the following messages are displayed: 


IL61 MEDIA NAME NOT AVAILABLE FOR FILENAME 
IL62 GIVE MEDIA NAME OR REPLY CR 


The operator must enter the volume name of the backing store SYS.TVMFi. 


The file SYS.TVMF is a mandatory file. A session cannot take place without it. 
The absence or the error in opening this file causes the following message to be 
displayed. 


VM0O7 FATAL: THE SYS.TVMF IS MANDATORY AND IT HAS NOT BEEN 
POSSIBLE TO OPEN IT 


The system then enters an endless loop. A new storage load must be performed and 
the operator must enter the SYS.TVMF parameter. 
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The absence or an error in opening of non mandatory files, 1.e. SYS.TVMF1, 
SYS.TVMEF2, ....... SYS. TVMF15 causes the following warning message. 


VMO8 WARNING : THE SYS.TVMFi HAS NOT BEEN OPENED 
and the corresponding backing store file is not used for the session. 


If all the TVMF files are inactive, then the following message is displayed. 


VM10 FATAL: AT LEAST ONE TVMF FILE IS COMPULSORY 


The system then enters an endless loop. A new storage load must be performed and 
the operator must specify the disk volumes which contain the SYS.TVMFi backing 
store files. At least the SYS.TVMF file must be present. 

All disks declared in the TVMF option have the BKST attribute (as returned by the 
DHW operator command), except for the system disk (if present in the list), which 
has the SYSTEM attribute. 

The disks declared in the TVMF option are not normally resident (except for the 
system disk, if relevant). Those which are required to be resident must be declared 
in the RESIDENT option. 


Disk mirroring is not supported on BKST disks. If a MIRROR disk is declared in 
the TVMF option, it is rejected with the message IL80 (refer to "BKST" above). 


Date and Time Management 


During a GCOS 7 session, dates and times included in the various console 
messages are always expressed in "local date and time". This local date and time is 
the result of the algebraic addition of the "reference date time" to the "time 
deviation". 


For example, the reference date and time can be set to the Universal time: UT (or 
GMT time) and the time deviation set to the local time zone. On such a site, 
changing from winter time to summer time is made by adding one hour to the time 
deviation value. 


On all the DPS 7000 systems the reference time is kept in the service processor 
clock and is never managed through GCOS 7. On DPS 7000/A, 

DPS 7000/4xx/Cxx, DPS 7000/5x0/7xx/8x0/Dx0/Mx0/MTxx models the time 
deviation is available through this clock and is managed globally by the service 
processor and GCOS 7. On other hardware models, as no time deviation is 
available on the service processor, time deviation is managed by GCOS 7. 


On DPS7000/XTA, when V7000 starts, the reference date and time (UT) are got 
from WINDOWS™ instead of Service Processor. 

Time deviation is managed through V7000 System Control. 

(refer to V7000 Operator's Guide). 
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When a GCOS 7 session is started the reference date and time is read from the 
service processor. Depending on the hardware models, the time deviation is read 
either from the service processor or from the previous GCOS 7 session 
information. Then, the current local date and time is calculated and displayed on 
the console followed by the time deviation value. Example: 


>>> hh:mm:ss MMM dd,yyyy TIMEDEV = +01.00 


If the local date and time is lower than the date and time at the end of the previous 
GCOS 7 session the following messages are displayed: 


>>> PREVIOUS LOCAL DATE : hh:mm:ss MMM dd, yyyy TIMEDEV = shh:mm 
>>> CURRENT LOCAL DATE : hh:mm:ss MMM dd, yyyy TIMEDEV = shh:mm 
IL70 SYSTEM WILL BE FROZEN 
IL70 DO YOU AGREE (Y OR N) ? 


The s is either - or + . The answer Y (yes) indicates that the operator agrees not to 
have the local time set back (An After Journal exists on the site.): the system will 
be frozen until the current local time passes the previous local time. The answer Y 
is forced in AUTO mode. Any other answer implies that the current local date and 
time is acceptable for starting a new session. 


The operator may update the time deviation later on, at ILO1 OPTIONS question 
through the TIMEDEV option or during the GCOS 7 session through the MDTIME 
operator command (Refer to Chapter 8 Description of the Operator Commands). 


When the time deviation is updated from the GCOS 7 side (IL01 or MDTIME) the 
new value is sent and registered into the service processor if the hardware model 
allows it. 


When the time deviation is updated by the service processor operator the new value 
is communicated to GCOS 7 only for display on the system console. It is not taken 
into account until the next reloading. 


At the ILO1 OPTIONS question it is also possible to change the GCOS 7 date and 
time through the DATE option. This new date will be valid only for the current 
session, it is neither kept from session to session nor transmitted to the service 
processor. 


Each time the DATE or the TIMEDEV option or both are keyed in at ILO1 
OPTIONS, the system checks that the new current local time is not lower than 
previous local time, as is described above. When the system freeze is rejected 
(answer not equal to Y at IL70) the IL01 OPTIONS question is asked again in 
order to update the date or time deviation values or to continue the processing 
by pressing "Enter". 
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During a GCOS 7 session (from SYSTEM READY to END OF SESSION or 
CRASH), the operator may modify the local time through the MDTIME command 
(time deviation modification). It is not possible to modify the reference time at the 
GCOS 7 level. 


When the SP time-of-day device is unavailable or failed the IL92 message is 
displayed on the system console (IL92 UNABLE TO GET CLOCK FROM SP), 
then a new local date and time is calculated depending on the system context. 
The algorithm is summarized in the following table: 


Table 3-1. Time and Date Algorithm 
4 RELOAD and | RELOAD and HW INIT and 
Previous No Previous Status No 
Status Previous Status Previous Status 
GCOS 7 Reference | TOD CPU TOD CPU Previous TOD 2/1/81:00/00 
(TDO) 


Deviation (TDEV) | deviation deviation 
(TDEV_Prev) (TDEV_ Prev) 
TDEV_Prev TDEV_Prev 
CONSEQUENCES | None Local date & time | Local date & Wrong local and 
=reference date | timeislate:(a | reference date & 
& time few minutes) time 


TOD_CPU Time-Of-Day register in Central Processing Unit (valid 
after reload function) 

Prv.St. Previous status : it gives information stored at GCOS 7 
session termination time. 

TOD Prev Reference Time (TOD) stored in the previous status 

TDEV_Prev Time deviation value stored in the previous status 


WARNING : on DPS 7000/XTA the date and time displayed at the right side of the 
Windows™ tool bar is the Windows™ local time. It is not reference date and time. 
This reference is internal to the system. It must expressed in Universal Time (UT) 
and can only be set through a BIOS command. 
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3.4.5 Device Testing and Volume Recognition at GCOS 7 Restart 


3.4.5.1. General 


After the dump has been taken and/or the restore has been made (if necessary), ISL 
is terminated and GCOS 7 becomes active. 


The initial AVR (Automatic Volume Recognition) phase takes place. The state of 
all devices of the configuration is tested. Messages are displayed for all READY 
storage devices (disks, tapes, cartridges, diskettes) and printers. 


DV21 AVR messages are sent to the operator console, except for standard 
MIRROR disks (see below): 


message for disks 


{ [NvToc} } 
{ SYSTEM NvToc } 
volnm { BKST [NVTOC] } 
{ SRV NVTOC } 
{ NSTD [FBO] } 
{ } 


{ 
{ 

hh.mm dvnm PREMOUNTED { 
{ NSTD MIRROR 
{ 


we eer er 


NSTD 


messages for tapes and cartridges 


hh.mm dvnm PREMOUNTED { volnm } [AUTO] attributes [PROTECT] 
{ NSTD 
{"WORK" } 


where attributes are built from tape or cartridge device attributes. 
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messages for printers 


hh.mm dvnm PREMOUNTED volnm 

If at least one sharable disk device is seized by the other system, the following 
message is displayed: 

DV34 GCOS: dvnm AVR IN PROGRESS: TRAFFIC WILL RESUME 

The lists of resident and shared disks are processed. Possible error messages have 


been described in section 3. When the DV43 question is asked, it must be answered 
as explained below in Section 3.4.5.2 DV43 Question. 


When no error is detected, resident and shared disks are allocated to X1 (system). 
Likewise, BKST disks are allocated to X1, including the SYSTEM disk. In 
addition, on DPS7000/An systems, the service disk is allocated to X1. 


MIRROR disks are then processed, if any exist on the site (system configured with 
MIRROR = YES). Pairs of mirrored copies are identified and checked; 
resynchronization, automatic refilling or copy invalidation may take place at that 
time. AVR messages are sent to the operator console: 


messages for MIRROR disks 


MRO1 dvnm PREMOUNTED volnm MIRROR { PRIM [ RESYNCHRONIZED ] } 
{ SEC [ RESYNCHRONIZED ]_ } 
{ ALONE } 


MRO1 dvnm PREMOUNTED volnm MIRROR { WILL BE COPIED } 
{ WILL BE REFILLED } 


Refer to the Mirror Disks User's Guide for further details. 
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3.4.5.2 DV43 Question 


3.4.6 


3-58 


When the DV43 question has been asked: 


0/1 DV43 REPLACE BY: 


the system is waiting for an answer and the operator must: 


e issue a BREAK, 

e at"S:", enter the system question number (01 in the above example), 

e enter the correct list of either shared or resident volume names, separated by 
spaces or commas, and press ENTER; if the new list is empty, then ENTER is to 
be pressed directly after the system question number. 


The DV43 question is asked after: 


e DV37 GCOS: NUMBER OF RESIDENT EXCEEDS 10, NEW LIST IS 
REQUIRED. 
e DVO5 RESIDENT MIRROR FORBIDDEN: 
<volnml> <volnm2>... 
e DV40 RESIDENT NOT FOUND: 
<volnml> <volnm2>... 
e DV41 SHARED NOT FOUND: 
<volnml> <volnm2>... 


System Ready 


After the Restart session is completed, the system becomes READY, and the 
message: 


hh.mm GCOS - RELEASE V7 XXXX READY mmm dd, yyyy 


KREKKKKKKKKKKEKKKEKKKEKKEKKEKKKEKKKKKKEKKEK 


is displayed. This means that Storage Load is now completed and that GCOS 7 is 
fully operational. Most of the service jobs are started. Some jobs may be in the IN 
SCHEDULING state if a Warm Restart was requested. 


They are started as described under "Job Scheduling and Execution" in Chapter 5 
Running User Jobs Under GCOS 7. 


Some jobs may be EXECUTING, if the previous System Session was terminated 
by a TERMINATE SYSTEM command (TSYS). Jobs which were interrupted 
between steps are now resumed. 


Some outputs may be READY and the Output Writer must be started using the 
START_OUTPUT_WRITER command (SOW). 


New jobs can be introduced by using the Input Reader or the 
ENTER _JOB_ REQUEST Command (EJR). 
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3.4.7 Example of Answer to the IL01 OPTIONS? Question 
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IL47 WARNING MEMORY HAS BEEN CONFIGURED 


>>> ISL 142 15 -01 (13) / 2 
>>> 11:18:17 JUN 25, 1992 TIMEDEV = + 02:00 
>>> LOAD PCLC = 1502 


SYSTEM PREVIOUS STATUS ON 6/25/92 AT 11:16:37 
SYSTEM RESTART 
* ILO1 OPTIONS? 
Ts 
OP65 NO RECORDED REPLY FOR SYSTEM QUESTIONS 


11.19 MS93 PREMOUNTED HIT193 BKST NVTOC 

11.19 MS92 PREMOUNTED HIT192 SYSTEM NVTOC 

11.19 MS97 PREMOUNTED HIT197 

11.19 MS94 PREMOUNTED HIT194 NVTOC 

11.19 MS28 PREMOUNTED FSD528 NVTOC 

11.19 MS17 PREMOUNTED FSD517 

DV34 GCOS: MS95 AVR IN PROGRESS: TRAFFIC WILL RESUME 
11.19 DK11 PREMOUNTED MD2 SZ256/DCE/MD 

CL60 NUMBER OF SYS.SPOOLS : 3 


T 


TWO1 GENERATION NOT PERFORMED 

11.21 X297.1 ABORTED LAEH OPERATOR Z SEV6=61000 
11.21 X298.1 ABORTED FEPS OPERATOR S SEV6=61000 
RSO6 X299 REACTIVATED 

11.21 X301.1 ABORTED WRITER OPERATOR W SEV6=61000 
11.21 X307.1 ABORTED IOF OPERATOR Z SEV6=61000 
11.21 X306.1 ABORTED RAEH OPERATOR S SEV6=61000 
11.22 PR11 PREMOUNTED 0000 

11.22 GCOS7 RELEASE V6100 6146 READY JUN 25, 1992 


KREKKKKKKKKKKEKKEKRKEKRKKKEKEKKEKKEKKKEKKEKKKKEKKEE 
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Terminating the Session 


Normal Termination 


A session is normally terminated by using the TERMINATE SYSTEM (TSYS) 
command, whereby all the system's activities are stopped at the end of the session. 


The TERMINATE SYSTEM command is refused if there are any jobs which are 
suspended (during a step execution) due to operator action (HJ-HOLD_ JOB). As 
soon as the TERMINATE SYSTEM command is accepted, no more jobs are 
scheduled and the commands HJ/RJ-RELEASE JOB/FJ-FORCE JOB are refused. 


A normal termination means that: 


e No step is executing; a TERMINATE SYSTEM command causes all executing 
jobs to be suspended at the end of their current step or to be aborted at the next 
step checkpoint. 


e No job is suspended in a step. 


e The Output Writer is stopped. All WRITER service jobs are terminated at the 
end of their current outputs. 


e The system files are closed. 


NoTE: 
Outputs of jobs remain in the SYS.OUT file to be output at the next session. 


After you enter the TERMINATE SYSTEM command and shutdown is completed 
(indicated by message AV02), you can either power down the installation or reload 
the system. 


The TERMINATE SYSTEM command used to shut down the system may now be 
submitted by either: 


e an operator using a system console, 
e anetwork operator. 


For the DPS 7000 an optional parameter (INIT) has been added to the TSYS 
command to request that a hardware initialization occur before the next ISL (useful 
for changing the system technical status). You may also predefine the identifier of 
the device from which the system will be loaded at the next session. 


Further, the TSYS_-GCOS_PWROFF command not only terminates the system, but 
also powers-off the hardware. (Not available on DPS 7000/2X0/3X0 or 

DPS 7000/XTA series). Refer to Chapter 8 Description of the Operator Commands 
for a description of the TSYS (TERMINATE SYSTEM) command. 
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On DPS 7000/XTA series, the TSYS power off command terminates GCOS but 
the power off action is not available. Power off can be done using Windows™ shut 
down command. 


The SHUTDOWN procedure automatically resets the reconnection time to zero. 
You may define a new GCL command on-site to include specific commands before 
issuing the TERMINATE SYSTEM command. For example, you may process the 
accounting file, or shut down telecommunications. 


Shutdown involves two major phases: 


1. 


Enter the TERMINATE SYSTEM command. The message SHUTDOWN IN 
PROGRESS is sent to all operators. From then on, no new job can be 
scheduled and those jobs being executed are held at the end of their current 
step. Not even main operators are authorized to log on under IOF. IOF users 
who are still logged on at system consoles are disconnected. IOF users logged 


onto the network are also disconnected when you enter the 
TERMINATE TELECOM SERVER command (TTSVR). 


Disconnect the other operators still logged onto the network by entering the 
TT or TTSVR STRONG command. Before entering BYE, check that all the 
shutdown conditions are satisfied because you will not be authorized to log on 
again. Finally, the OMH job is shut down. 


3.5.2 Abnormal Termination 
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Ifan 


error is detected which cannot be bypassed, the system crashes. The following 


message is displayed: 


* AVO1 GCOS: CRASH 


[PARTIAL] DUMP AVAILABLE } 
REDUCED DUMP } 
NO DUMP } 
TRUNCATED DUMP } 


{ 
-{ 
{ 
{ 


This is the first line of a three-line message; the second line may be one of the 
following: 

AVO1 CHANNEL EXC. ON MCnn pcpp 

AVO1 IOP EXCEPTION ON iopnm 

AVO1 REASON : HARDWARE FAILURE 

AVO1 REASON : SYSTEM EXCEPTION 

AVO1 REASON : CALL TO PANIC 

AVO1 REASON : SYSTEM RESTART 

AVO1 REASON : EMERGENCY SHUTDOWN 
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while the third line is: 
AVO1l PA XxXXXXXXX XXXXXXXX XXXXXXXX 


NO DUMP indicates that the system was unable to store the dump on disk. It may 
indicate a problem related to either the system disk, the disk unit, or the Mass 
Storage Processor. Refer to the appropriate Operator Guide or Operator Reference 
Manual. 


The second message line gives the reason for the crash, and the third provides 
additional information (crash parameters). 


To shut down the system as cleanly as possible and take a dump, issue an SR 
command under SPOS. Data updates are stored and are used at the next warm 
restart to restore the files, jobs and outputs. 


After a system crash, the installation can be powered off, or processing 
recommenced. 


In all cases, refer to the appropriate Operator Reference Manual. 


IMPORTANT: 
NEVER, under normal circumstances, terminate the system by using the 
INIT/SYSTEM INITIALIZE/RESET or POWER OFF pushbuttons or the 
POWER OFF command. 


When the system stops due to failure or discharge of the back-up battery, the 
following messages are sent: 

AVO1 EMERGENCY SHUTDOWN 

AVO1 POWER FAILURE 


When the system stops due to failure of the fan, the following messages are sent: 
AVO1 EMERGENCY SHUTDOWN 
AVO1 FAN FAILURE 


When the system stops due to overheating, the following messages are sent: 
AVO1 EMERGENCY SHUTDOWN 
AVO1 EXCESSIVE TEMPERATURE 


If sufficient charge remains in the battery, a control dump is taken first. 
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3.5.3 Information Left Over After Termination 


After system termination, information remains in the system files about the 
following: 


e Jobs known to the system, 
e Input enclosures associated with these jobs, 
e Output prepared by (or for) these jobs. 


Some information remains in the SYS.LIB system file. 
The system dump, if there is one, is stored on the backing store file SYS.BKST. 


After an abnormal termination (crash) the system context is partly saved in BKST 
and partly kept in main memory. The a reload is automatically forced in order to 
process the system dump (refer to Section 3.4.3.5 DUMP). The error context is 
rebuilt using BKST and the main memory part that is not damaged by the reload 
mechanism. 


In the event of a system shutdown, i.e. termination of a session by means of the 
TERMINATE SYSTEM command, all system files are closed. In any other case 
they are left open, as are the user files, to be recovered by File Salvager if a warm 
restart is requested at the next storage load. 


3.6 Error Messages Displayed During System Loading 


47 A2 53US 


IL type, AV type, DV type and VM type messages may appear at the system 
console during GCOS 7 loading. For a complete explanation of these messages, see 
the Console Messages Directory. 
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4. Operating under GCOS 7 


4.1 Introduction 
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After the system is initialized, programmed operator applications exist to perform 
the following functions: 


e adjust system parameters depending on such conditions as date, time, system 
load, and urgency of jobs; 

e schedule jobs; 

¢ correct errors and activate preventive maintenance; 

e check system performance, detect lack of resources, plan capacity, and tune the 
system; 

e provide job accounting; 

e collect statistics periodically and provide specialized displays. 


You can perform these functions either automatically or manually from the 
following workstations: 


e local system consoles. 

e remote terminals if a link is established; 

e remote terminals connected to another DPS 7000 (known as system control 
center) by use of the primary network. In this case, the operator may control 
several systems simultaneously. 


At any time, one or several of these workstations (up to 16) may assist in operating 
a DPS 7000 System. For example, a local console may receive media mount 
messages; a remote terminal may be dedicated to the TDS while another remote 
terminal may receive all urgent messages such as errors, aborts and alarms for 
exceptional events. If several satellite systems are connected to the same network, 
you may control them from: 


e either a central console; 
e or several consoles. 


For example, in the latter case, you may group all application messages on one 
console and route all operator requests and urgent messages to another. 
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Figure 4-1. Control Consoles 
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The simplest configuration. 

The system is controlled by the Local 

Console. The "flags" on the right symbolize 
terminals connected through a communica- 
tions processor. 


in» 


(2) 
Added to the local consoles, one of the 
telecommunication terminals is logged on 
with the MAIN attribute, giving it access to 
MAIN OPERATOR commands. (Not to be 
confused with the back-up local consoles 
present on redundant systems). 


oN 


IY 


Systems B and C are satellites of system A. 
In this way, a number of computers, located 
in differents places, can be operated from 
a single centralized control room. 
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4.2 Description of an Operator Workstation 
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The operator may use system consoles in line mode or IOF terminals in line or 
formatted mode. 


The GCL command language now includes the privileged MAIN operator 
commands. 


On a synchronous terminal, you may take full advantage of GCL menus, prompts 
and helps in formatted mode. Color terminals are supported. 


On hardcopy terminals as on system consoles, you may submit commands using 
GCL menus, prompts and helps in line mode. 


When you log onto the system, your initial profile is 


GCLMODE = GCL 
OPERATING MODE = CONS 
GCLFORM = LINE 
NOVICE = 
MENU = 1 


To facilitate operating in CONSOLE mode, it is recommended that you program an 
auto-transmit break function key on your terminal. 


The main operator may find it easier to receive messages by setting: 


PAGEMODE = 0. 


Asa MAIN operator you must not activate interactive processors. In interactive 
mode you might generate a mount or a recovery request. Because these requests 
could not appear on your terminal, deadlock would occur. Another reason why you 
must not execute in interactive mode is that the main operator jobs are executed 
with a high dispatching priority which means you delay the execution of user jobs. 


If a MAIN operator wishes to work under IOF, he must be registered under two 
separate projects in the catalog: one with the MAIN attribute, the other without it. 
Under the second project name, he may use interactive processors, for example, to 
scan outputs. 


To build a specialized workstation, open filters. Select the messages to be displayed 
on your terminal by submitting filter commands. You are advised to store filter 
commands in your startup sequence to avoid having to enter them at each session. 
For more information on filters, see Section 4.7 Filtering System Messages. 


Each logged-on operator works under a given PROJECT. Depending on the set of 
commands the system administrator grants to your project, you can access all or a 
subset of the privileged commands. Each installation may define its own GCL 
environments and the commands you may use within these environments. 
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The normal procedure is that the operator logs on under the IOF application with a 
project having the MAIN attribute. Once the system level prompt S: or the main 
menu appears, you may introduce commands. 


The Remote Multiplexed Operator Support (RMOS) enables you to monitor one or 
several sites using the same operator terminal without having to log on/off. For 
more information, see Chapter 9 Remote Multiplexed Operator Support (RMOS). 


GCOS 7 scans and adapts the I/O operations involving the main operator consoles. 
Thus software enables main operator consoles to: 


e communicate with terminals in formatted mode; 
e communicate with TTY-like terminals in unformatted mode; 


e substitute the default character (.) for certain unprintable characters, in particular 
escape sequences; 


e group messages if the operating mode is interactive. 
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4.3 Connection/Disconnection 
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Begin by entering a break on your console or terminal. When the system prompts 
you, enter the proper password and identify yourself to the system. 


The installation startup and the main operator startup are different when compared 
to previous releases: 


e When the system is ready, a system startup is automatically executed. Its 
purpose is to set up installation-specific parameters and initialize important 
activities, for example, start telecommunications. This is useful when the main 
operator of a remote controlled site logs on through the network. 


e Like any IOF user, the main operator has one or two startup levels: 


"USER", "PROJECT" (or "SITE"). 


The user startup level allows a very specific processing context to be established 
- for example by submitting filter commands. The project level startup specifies 
project level options. 


A site operator can become a main operator by a logging on a console or terminal, 
provided that he has the default attribute MAIN or that he specifies a project that 
has the MAIN attribute in the site catalog. 


NOTE: 
To activate an interactive processor, do not log on under a project having the 
MAIN attribute, for example, in the case of the system administrator who 
wishes to activate an interactive processor. If the SYSADMIN project has the 
MAIN attribute, the MAINTAIN CATALOG functions can be done only in 
batch mode. 


It is possible to activate an interactive processor from a system console provided 
that the current user does not belong to a project with the MAIN attribute. For 
example, on a remote controlled site, IOF users may use local consoles if no main 
operators are connected. 


A main operator can still log on in the same way as in previous releases. For sites 
where several operators need to be logged on simultaneously, the multi-console 
option may be purchased. 


A main operator may log on and off without affecting system operations. Similarly, 
a console failure or an off-line transition does not affect the system which can work 
in unattended mode. 


The WAITS FOR RECONNECTION state does not apply to MAIN consoles. The 
context of the previous telecommunication session is lost if you log on again. 
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4.4 Distributing Tasks 


Read this section if the multi-console option was purchased for your site. 
Remember the multi-console feature enables several main operators to log on 
simultaneously. 


What characterizes an operator session? 


e acommand environment, 
¢ operator attributes, 


e filter sets. 


4.4.1 Command Environment 


The environment is a set of commands which are accessible to a common set of 
users. Each operator works under a given project which has a default environment. 
The system administrator defines these environments and grants different operators 
access to privileged commands. 


You could have the following environments: 


e One in which you use commands to set classes, multiprogramming levels and 
the allocation of non-sharable resources among several operators. A single 
project could be associated with this environment in which the command "verbs" 
TERMINATE, FORCE and HOLD would be extensively used. 


e One dedicated to handling device operations. In this case, you could not handle 
jobs during execution unless you use the CANCEL REQUEST command. 


e An environment dedicated to the SYS.OUT and other system files. 


e An environment providing access to all privileged commands accessible only by 
the system administrator. 


To add a new command to your environment, for example, if you want periodically 
to launch file saves to your current working environment, use the GCL 
MAINTAIN COMMAND utility. 
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4.4.2 Operator Attributes 


These determine how commands are executed and how messages are issued. You 
can specify operator attributes at project level in this catalog. Operators may have 
up to two attributes: MAIN and STATION whereas other end users have the IOF 
attribute only. Depending on the attribute value sent to the system, the system 
executes commands differently. For instance, a STATION operator can access only 
the objects belonging to his station whereas a MAIN operator can access all objects 
in the system. The MAIN operator attribute is important for the reception of system 
messages. See Section 4.7 Filtering System Messages. 


4.4.3 Filter Sets 
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By using the CREATE FILTERSET command, a main operator may specify the 
class of messages that he wishes to receive. On a site where several operators are 
active simultaneously, a filter set defined by a main operator can be assigned a 
higher priority relative to filter sets defined by other main operators. If a main 
operator with the highest priority for a certain class of message logs off, further 
incoming messages in this class are automatically sent to operators with the next 
highest priority for this class of message. See Section 4.7 Filtering System 
Messages for more information on filters. 
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System Functions 


Backing Store Files 


Since the size of the main memory is not infinite, the system uses backing store 
files to contain information and temporarily to store executing programs not being 
processed by the system. The contents of the backing store files are mainly: 


e The static segments of the system. 


e Permanent information (permanent means kept from one RESTART, COLD or 
WARM, to another): 


— Pre-initialized load modules. 
— Sharable modules. 


— Checkpoints and repeatable user programs (maintained at WARM 
RESTART). 


Permanent Virtual Memory Files (VMF) used by the system. 


e Temporary information 
— Non-repeatable user programs. 
— Dynamic and temporary segments of the system. 
— Temporary Virtual Memory Files used by the system. 


When several backing store files are used their names and their contents are as 
follows: 


SYS .BKST static segments of the system and temporary 
information (except TVMF) 

SYS .PVMF permanent Virtual Memory Files of the system 

SYS.LIB permanent information as explained above (except 
permanent VMF) . 

SYS .TVMF temporary Virtual Memory Files of the system 


SYS.BKST 1...15 temporary information, as described above 
(except TVMF) 

SYS.PVMF 1...15 } 

SYS.LIB 1...15 } additional files, as required. 

SYS.TVMF 1...15 } 


Every backing store disk must be mounted when ISL is performed. Since 
SYS.PVMEF and SYS.LIB contain only permanent information, a change of the 
disk cannot be performed at a warm restart. 
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NoTES: 

1. The minimum size of SYS.PVMF is 30 cylinders of FSD 500, irrespective 
of the configuration. 

2. Any change to the SYS.LIB file, which can only be done at ISL time, has 
the following consequences: 
The permanent information has to be re-established. 
The system sharable modules are reloaded (automatically performed by the 
system). 
The user sharable-modules (if any) must be reloaded. 
The PLM must be reissued. 

3. SYS.BKST always increases during the life of a system. The life of the 
segments belonging to a system, and which are not deleted, is the life of a 
GCOS session. Pages are swapped on BKST depending on the system 


load. Thus if more of the system is loaded, the BKST increases further. 
The BKST corresponding to segments of J which is finished is restored. 


4.5.2 Main Operator Console Log 
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All system operations may be logged in a system file called SYS.LOGC. If there is 
more than one console using the MAIN operator privilege, the SYS.LOGC file is 
the only place where all dialogs between the various operators and the system are 
registered. Its records are therefore useful for solving problems concerning system 
operations. It is activated after the ISL is completed and contains messages sent to 
main operators as well as operator dialogs including commands and associated 
replies. 


NOTE: 
The messages sent explicitly to a main operator are not recorded in the 
SYS.LOGC if this operator is not logged-on. 


The START CONSOLE LOG (SCLOG) and TERMINATE CONSOLE LOG 
(TCLOG) commands manage this file. SCLOG must not be issued while TCLOG 
is being executed and vice versa. 


The SCLOG CLEAR option makes the SYS.LOGC file available to the system by 
erasing its contents and then starts logging the new session. TCLOG terminates the 
logging and makes the SYS.LOGC file unavailable for GCOS 7; SCLOG restarts 
the logging. 


We recommend that the SCLOG, SCLOG CLEAR and TCLOG commands be used 
only for recovery after incidents. 
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If during the logging of the Main System Session the hard copy fails, this does not 
result in the loss of information. 


The use of the SYS.LOGC file enables a site without hard copy to record the 
system session. The DISPLAY REQUESTS (DR) command allows the system to 
list all the messages for which operator intervention is required. This is very useful 
for a site that has only a screen or for a site that has a very large number of 
messages. 


It is very important to have enough space in the SYS.LOGC file because it may be 
overwritten and information lost. When the file is half-full the following messages 
are displayed: 


ELO1 SYS.LOGC FILE 50% FULL 
* ELO3 RUN PRLOGC 


We recommend that at this point the PRLOGC utility be run to print the 
SYS.LOGC file and free the space within it. 


The full syntax and description of the PRLOGC utility are given in Appendix B: 
Calling System Utilities. 


PRLOGC may only be started if the SYS.LOGC file is made available by GCOS 7. 
If the TCLOG command has been issued, the utility PRLOGC is not executed. 


If the SYS.LOGC file is full and PRLOGC has not been executed on it, then the 
following messages are displayed. 


ELO1 SYS.LOGC FILE FULL 
DATA LOST UP TO date 


This means that all information that was in the file up to "date" has been lost. If 
you have problems with the current SYS.LOGC file, you may switch to another as 
follows: 


e stop the current SYS.LOGC activity by TCLOG, 

e rename the current SYS.LOGC file, 

e allocate another SYS.LOGC file, 

e restart the SYS.LOGC activity with the new file by SCLOG CLEAR. 
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Certain abnormal situations may occur which result in the following messages 
being displayed: 


ELO1 SYS.LOGC FILE REINITIALIZED 


This means that the SYS.LOGC file has been reformatted after a device failure or 
had been initialized on another system disk (disk duplication). 


ELO1 SYS.LOGC FILE UNAVAILABLE 


This means that the SYS.LOGC file cannot be accessed due to a hardware failure, 
for example a bad track. This message can also appear if SYS.LOGC has not been 
pre-allocated (reserved) at the time of installation. 


Any main operator may scan the contents of SYS.LOGC on his screen by using the 
DISPLAY CONSOLE LOG (DCLOG) command. You can retrieve data by giving 
either its value or its date/time. Moreover, SYS.LOGC may be scanned either 
forwards or backwards on a page mode basis. 


GCOS 7 System Operator's Guide 


4.6 Console Message Handling 


You may reduce console traffic by routing only essential message to an operator's 
console. 


Important messages are of two types: 


e Request messages (class R) which require an operator reply or action. 
e Class M messages which require manual action. 


To receive only important messages, use filter type criteria R in the CRFLT 
command. 


Messages are issued to those operators with the appropriate filters. If the number of 
operators on-line changes and the filters created vary, then these changes are taken 
into account at the next repetition of a repeatable message. 


If the message table becomes full, new class R messages are queued until space is 
freed. 


To find out the number of pending requests, enter the DISPLAY REQUESTS 
command. If the request is a question, the requesting job remains in the WAITS 
FOR OPERATOR REPLY state until an operator replies. If another operator tries to 
reply to the same question, the message INVALID REPLY IDENTIFIER OR 
ALREADY REPLIED appears on the operator terminal. If the requesting job is 
aborted or terminated, the question is also cancelled. 


In unattended mode, it is recommended you ensure that as few jobs as possible ask 
MAIN operators questions and that programs provide replies. 
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4.7 Filtering System Messages 


4.7.1 What is a Filter? 
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A filter lets certain messages be displayed on your terminal and rejects, or stops 
others. So you use a filter to select the messages you wish to be displayed on your 
terminal. See Figure 4-3 Setting up Filter Sets and Filters. Consider that the system 
issues several messages named message 1, message 2, message 3, and message 4. 
Filters adapt these messages to a particular operator. 


>_> Operator V 
Ss F 1 eee Operator W 
Y message 1 | 

L ee eee > 

: message 2 7 |4 S) OPerator x 
E message 3 R en ee eee > 

S| ot [poo 2) Operator ¥ 

message 4 S) ‘Cale e ee > perator 
0 > Operator Z 


* represents the number of receivers. 


Message 1 is sent to operator X only. 

Message 2 is sent to four operators: V, X, Y and Z. 
Message 3 is sent to two operators: X and Y. 
Message 4 is sent to no operators. 


Figure 4-2. 


Operator V 


Operator W 


Operator X 


Operator Y 


Operator Z 


Using Filters 
uses filters which let message 2 pass through but 
which reject messages 1, 3 and 4. 


uses filters which reject all four messages issued by the 
system. 


uses filters which let messages 1, 2 and 3 pass through 
but which reject message 4. 


uses filters which let messages 2 and 3 pass through 
but which reject messages | and 4. 


uses filters which let message 2 pass through but 
which reject messages 1, 3 and 4. 
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Messages can be either specific or generic. 


A specific message: the issuer explicitly identifies the receiver who always 
receives the message. 


A generic message: the system issues a message to the generic class of operators 
who have set the filter to accept the message. 


Filters only apply to generic messages. Filter criteria are the following: 


KEY - name-8 


TYPE 
* = all messages, 
R = an operator reply, either a manual or automatic action is 
needed, 
M = the operator must take action. 


JOBID - the identification of the issuing JOB, 
RON - the run occurrence number of the issuing JOB. 


By default, if you do not define filters, you will not receive generic messages. 


The commands for defining filters are fully described in Chapter 7 Description of 
the Operator Commands and summarized below: 


- CREATE FILTERSET command creates a filter set. 


- CREATE FILTER command creates a filter, that is, defines the message 
characteristics you want to receive. 

- DELETE FILTER command deletes filter set(s) or filter(s) previously 
created. 

- MODIFY FILTER command activates or deactivates-activates a filter or a 
filter set. 

- LIST FILTER command lists filter(s) or filter set(s). 
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OPERATOR 
filter set 1 filter set 2 filter set 3 16 filter sets 
max. per operator 
filter 1 filter 2 filter 3 16 filters max. 


per filter set 


Figure 4-3. Setting up Filter Sets and Filters 


A message must satisfy all defined criteria to match the filter. 


EXAMPLE 1: 


CREATE FILTER Al A101 I KEY = (ABO1,AB99) JOBID = TEST; 


Defines filter A101 within filter set Al. For a message to be accepted by this filter, 
its key must be in the range of ABO1 and AB99 and must be issued by the job 


TEST. 
CRITERIA 

KEY TYPE JOBID RON Does the message 
match the filter? 

AB99 M TEST X45 yes 

AB50 R TEST X10 yes 

DV08 M TEST X55 no 

AB35 R APPL1 X99 no 

Q) 
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EXAMPLE 2: 
CRFLT Al A101 I TYPE = M JOBID = APPL1 RON = X32; 


For a message to be accepted by this filter, its type must be M (message requiring 
action), and it must be issued by the job APPL1 with run occurrence number X32. 


CRITERIA 

KEY TYPE JOBID RON Does the message 
match the filter? 

AB31 M APPL1 X32 yes 

DV59 M APPL1 X32 yes 

OPO5 M APPL1 X32 yes 

OPO5 M APPL1 X32 yes 

OPO5 M APPL2 X32 no 

OPO5 M APPL1 X33 no 


4.7.2 Filter Set 


Filters are arranged within filter sets. A filter set is a set of filters (maximum 16 
filters in a set) defined with an associated priority. Each time a generic message is 
issued by the system it is submitted to all defined active sets and filters. 


A generic message is sent to an operator if: 


e this message matches at least one active filter set belonging to this operator. A 
message matches a filter set depending on the type of filter (inclusive, exclusive, 
or mandatory). 


e the priority of the first matching filter set allows it. 
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4.7.3 Inclusive, Exclusive, and Mandatory Filters 


To match a filter set, a message must match: 
e at least one of its inclusive filters (if any), 
e none of its exclusive filters, 


e all its mandatory filters. 


EXAMPLE I: Select all generic messages 


CRFLTST Al 0; 
CRFLT Al A101 I TYPE = *; 


CRITERIA 


KEY TYPE JOBID RON Does the message 


match the filter? 


ABO1 M TEST X52 yes 
ABO1 M TEST X108 yes 
DV31 M ANY X305 yes 
Q) 

EXAMPLE 2: 


Select all generic messages whose message keys begin with OP. 


CRFLTST Al 0; 


CRFLT Al A101 I KEY = (OPO1, OP99); 
or 

CRFLTST Al 0; 

CRFLT Al A101 M KEY = (OPO1,0P99) ; 


CRITERIA 


KEY TYPE JOBID RON Does the message 


match the filter? 


| 
| 
| 
APPL1 x52 «| yes 
| 


OPO1 R 

OP99 M TEST X108 yes 
DV31 M TEST X108 no 
Q) 
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EXAMPLE 3: 


Select all generic messages issued by the job TEST with ron X245 where the 
message key beings with AB. 


CRFLTST Al 0; 
CRFLT Al A101 I KEY = (ABO1,AB99) ; 
CRFLT Al A102 M JOBID = TEST RON = X245; 


CRITERIA 

KEY TYPE JOBID RON Does the message 
match the filter? 

AB35 M TEST X245 yes 

AB35 R TEST X245 yes 

OP58 R TEST1 X245 no 

OP58 R TEST X246 no 

OP58 M TEST X245 no 

C) 

EXAMPLE 4: 


Select all generic messages issued by the job TEST with ron X245 excluding 
messages whose key is in the range AB60, AB69. 


CRFLTST Al 0; 

CRFLT Al A101 I TYPE=*; 

CRFLT Al A102 M JOBID = TEST RON = X245; 
CRFLT Al A103 E KEY = (AB60,AB69) ; 


CRITERIA 

KEY TYPE JOBID RON Does the message 
match the filter? 

AB35 M TEST X245 yes 

AB35 R TEST X245 yes 

AB69 M TEST X245 no 

DV35 R TEST X245 yes 

C) 
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EXAMPLE 5: 
Select all generic messages except those whose key is DV50. 


CRFLTST Al 0; 
CRFLT Al A101 I TYPE = *; 
CRFLT Al A102 E KEY = DV50; 


CRITERIA 


KEY TYPE JOBID RON Does the message 


match the filter? 


| 
| 
| 
DV50 M APPLL x38 | no 
| 
| 


DV51 M APPL1 X38 yes 
DV52 M APPL1 X38 yes 
Q) 


Priority of a Filter Set 


The priority of a filter set is a digit in the range 0-9. The highest priority is 0 and 
the lowest is 9. 


When several sets, belonging to different operators, match a message, this message 
is sent to the operators with the highest priority filter sets. 


EXAMPLE: 
The system issues a generic message which is submitted to active filters and sets. 


For the message to be sent to an operator, the following conditions must be 
fulfilled: 


e The message must match at least one filter set; 


e Matching filter sets belonging to other operators must have the same priority 
levels as the first matching set. 


Q) 
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OPERATOR (1) (2) 
does the message priority of 
match the filter set? the set 
operator 1 


operator 2 


operator 3 


operator 4 


operator 5 


4 
5 
3 
4 
0 
4 
8 
1 
0 
4 
4 
0 
0 
0 
4 
6 


The sets of higher priority and which match the message are Al, BI and D2. 
Operators 1, 2 and 4 will receive the message. 
Operators 3 and 5 will not receive the message. 


4-20 47 A2 53US 


Operating under GCOS 7 


4.8 Managing the Network 


Communications network management for the front-end processors is handled by: 


e TNS for the CNP7 integrated front-end processors in the DPS 7000/An and DPS 
7000/2x0 systems, 


e OCS (Open Communication Subsystem) for the CP7 Communications 
processors integrated in the DPS 7000/4xx /5x0 /7xx /8x0 /Dx0 /Mx0 /MTxx 
/TAxxx /XTA systems. 


e FEPS modules for the Datanets configured as front-end processors on the other 
DPS 7000 systems. 


Since the front-end processor provides the DPS 7000 with its communications 
capability, either TNS or FEPS must be operational before a communications 
session is available. 


Network operations are controlled and monitored by the network control operator, 
a role which the main operator may assume by default. Commands are entered in 
GCL mode. 


There are three principal categories of network control commands: 


1. Normal Operations: 


establishing and terminating the communications session: 
STSVR and TTSVR on TNS and/or FEPS and/or OCS 


starting and terminating the "load" function for the front-end processors: 
STSVR and TTSVR on FECM (ACTION=LOAD) 


establishing the MCS environment and controlling the MCS application: 
STSVR and TTSVR on QMON 
SNDQ (SEND QUEUE) 


MDQED (MODIFY QUEUE EDIT) 


monitoring the resources and functions of the network servers: 
DNET (DISPLAY NETWORK) 
DTSVR (DISPLAY TELECOM SERVER) 


2. Administration 


starting and terminating the "system generation" function for the front-end 
processors: 
STSVR and TTSVR on FECM (ACTION=SYSGEN) 


controlling and modifying the resources of the network: 
STSVR and TTSVR on DSAC 
MDNET (MODIFY NETWORK) 
EDD $NOI (ENTER DSA DIALOG) on the NOI mailbox 
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3. Maintenance 


starting and terminating the "dump" function for the front-end processors: 
STSVR and TTSVR on FECM (ACTION=DUMP) 


starting and terminating traces and debugging facilities: 
STTR and TTTR on TNS, FEPS, OCS and UFT 
EDD SDEBUG (ENTER DSA DIALOG) on the DEBUG mailbox 
DBSVR (DEBUG SERVER) 


executing and closing in line tests: 
EXTL and CLTL 


printing the trace file: 
PRITRE 


All these commands are fully described in the Network User's Guide. 
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5. Running User Jobs under GCOS 7 


5.1 Introduction 


This section consists of the following main subsections: 
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User Jobs: General Concepts 
introduces the main concepts and terminology of GCOS 7. 


Multiprogramming 
describes the various commands which enable the operator to control the system 
resources. 


Job Introduction 
describes how jobs can be introduced to the system, particularly through the 
Input Reader. 


Job Scheduling and Job Execution 
defines the respective roles of the operator and the system in controlling the 
passage of jobs through the system. 


Job Termination 
describes how a job may terminate. 


Output Writer 
describes the use of the Output Writer. 


Automatic Resource Management 
introduces the concepts of Automatic Resource Management (ARM) and 
summarizes the commands. 
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5.2 


5.2.1 


User Jobs - General Concepts 


Operators will find that the terms become gradually more familiar, but the broad 
picture which follows may be helpful: 


1. 
2. 


Programmers who send work to be executed on the computer are users. 


A user submits his work in discrete units, each of which is called a job. 
Accounting related to these jobs is performed by the system. 


A job takes the form of a set of records on a magnetic support, containing a 
series of Job Control Language (JCL) statements. JCL is the language with 
which the user tells the system the details of how he wants his batch job to be 
run and what work is to be performed. 


The interactive (IOF) user uses the GCOS 7 Command Language (GCL) as 
an equivalent to JCL. 


This is fully described in the IOF manual set. 
The user gives his job a name: the job identification (jnm). 


Each job consists of one or several steps: the system allocates a step number 
to each step. 


A step is the execution of a load module. 


A load module is a compiled program in a form such that it can be loaded 
into memory and executed. 


The whole life of a job in the system is a run. 


The system generates a run occurrence number (ron) for each job in the 
system. These are allocated sequentially with no possible duplication. This 
ron is the means by which the operator normally identifies a job once it has 
been introduced. (The ron consists of one to four digits preceded by an "X". 
The system itself uses X1, and X0 is not allowed). 


Some of the system functions are done by specific jobs called service jobs 
(e.g., JCL Translator, WRITER). These jobs run in a manner similar to user 
jobs, but in general they do not display any messages on the system console 
(see "Service Jobs" in this section). 


The Job State Concept 


A job passes through various stages between the time of its introduction and the 
time of its deletion from the system. The system assigns a Job State In accordance 
with the stage it has reached. 


The significance of these Job States is outlined in Figure 5-1, Figure 5-2, and Table 
5-1, in the following pages. 
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© Introduction > 


Introduced p 
_v 


© Translation > 


ees fe PAR a 
IN SCHEDULING ) £ 
joa ke fa 
y i Se SI J (*) See note below 

. ~ Selection - > ; _ " 

we 

SUSPENDED 
EXECUTING 4 
Sh a RI \-— (**) See note below 
oo ae ON Be 

( Termination a 


Vv 


FJ = FORCE_JOB Command 
OUTPUT 


HJ = HOLD_JOB Command 


ee ee RJ = RELEASE_JOB Command 
ewe i eysten ) * The HOLD state can also be explicitely requested by the 
_ : user submitting the job through a parameter of the 

ENTER_JOB REQUEST (EJR) command or the 

$JOB JCL statement. 


** Jobs in EXECUTING state may also be suspended 
automatically by ARM, the Automatic Resource 
Management facility (documented in this section). 


Figure 5-1. The Job State Concept 
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Table 5-1. Job States 


States in the Life of a Job 


1. INTRODUCED | A job, introduced by the Input Reader, must first be 
translated. Until translation is completed the job is said to be 


INTRODUCED. 
Once the job is submitted to the system it can be either: 
2. HOLD a. Held until released by the operator or another job. 
or 
IN b. Ready to be selected for execution. 
SCHEDULING 


3. EXECUTING The system selects, from the ready jobs, the one which is to 
be executed. The selected job is then started. 

3b SUSPENDED While in the EXECUTING state, a job can be temporarily 
SUSPENDED by the operator or by the system: no further 
instruction or execution takes place until it is released for 
execution by the operator or by the system. 

4. OUTPUT Eventually, job execution is terminated, but the job remains 
in the system waiting for the printing of its outputs to be 
completed. 

Once the output is complete the job is deleted from the 
system. 

5. IDLE Three types of service job (JCL Translator, WRITER and 
GTP) go into a specific state called IDLE whenever they 
have no more work to do. They automatically start 
EXECUTING whenever needed. 


In addition to the job concept, the system offers a data entry facility intended to be 
used in a cardless environment. Data is introduced to the system and moved into 
user specified libraries without any job execution. No job report is produced unless 
one is requested or an error occurs. Such data descriptions receive a ron at their 


introduction: 
Corresponding message Data enclosure state 
hh.mm. ron DATA ... ( INTRODUCED ) 
Rs a3 
Vin a ~\ 
hh.mm; ron OUTPUT COMPLETED ( OUTPUT 


\ 


The OUTPUT state for these rons is only reached when and if necessary. 
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C Introduction » 
M 
15.37 X23 IN MYJOB USER = JONES CLASS = G 


SPR = 4 STATION = MAIN 


IN Introduced 


a Y aie 
(_ Translation DD 


SCH IN SCHEDULING 


| 


15.39 X23 STARTED MYJOB JONES G 


EX EXECUTING 


Vv 
15.41 X23.3 COMPLETED MYJOB JONES G 


OUT OUTPUT 


v 
15:43 X23 OUTPUT COMPLETED MYJOB JONES G 


Figure 5-2. Job State Messages 
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The job MYJOB is introduced for user 
JONES at 15.37 from the MAIN console. 
It has received the job number 
X23 (known as the Run Occurrence 
Number, or Ron). Its class is G. 


MYJOB IS NOW STARTED meaning 
that it can share CPU time with other 
STARTED jobs. 


Job execution of Step 3 is completed. 
But the output is as yet to be 
completed (Note that output may 
begin before Execution is terminated). 


The job is now no longer known to the 
system. 


This figure shows some of the messages displayed by the system throughout a job's 
life. Note that messages relative to HELD and SUSPENDED states are not given 


here. 
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5.3 


5-6 


Multiprogramming 


The system allows more than one job to be executing at any one time. The number 
of jobs in execution (or suspended) at any one time is called the System Load. The 
maximum system load (the maximum number of "J") is defined at system 
configuration time. 


The system load includes user jobs and service jobs. User jobs are batch or 
interactive jobs, and service jobs are submitted by the system in order to achieve a 
service function (for example: Output Writer, Stream Reader, JCL Translator). 


If a job is suspended, it is still taken into account for the System Load. Service jobs 
are not considered in the multiprogramming level. 


It is part of the operator's duty to monitor and control the system resources used by 
different jobs in the system by means of the following commands: 


Table 5-2. Job Display and Control Commands 


Command 
DISPLAY LOAD To display information on all jobs in order to 
monitor the system. 
START LOAD To control user jobs through job class or job class 
MODIFY LOAD group, scheduling and execution priorities. Some 


TERMINATE LOAD |service jobs can also be regulated by commands 
involving job classes. 

FORCE_JOB To control user jobs through state, scheduling and 

HOLD_JOB dispatching priorities. 

MODIFY _JOB 

RELEASE JOB 
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5.3.1 The Job Class Concept 


Job classes are a means of organizing jobs into manageable groups according to 
their priority, profile, resource needs, and operational constraints. This simplifies 
job management and also leads to a more effective use of system resources. 


Job classes are identified by a name of one or two characters, A through Z and AA 
through ZZ. 


All have the following attributes: 


a scheduling priority (PRIORITY) 

an execution priority (XPRTY) 

a multi-programming limit 

a state at system startup (STARTED or NSTARTED). 


The system operator can: 


e use the MODIFY LOAD command to modify the scheduling priority, execution 
priority, and multi-programming limit (unless defined as non-modifiable at 
CONFIG time). 


e use the CONNECT LOAD command and DISCONNECT _LOAD commands to 
connect or disconnect a job class from a job group. 


Standard Job Classes 


Classes A through Z plus RB are delivered pre-configured. By default, they are 
automatically initialized (started) at system startup. 


A through Q: are intended for user jobs. 
P is the default job class for Batch jobs. 
Q is the default job class for IOF jobs. 


R through Z, and 
RA through ZZ: are reserved for service jobs. They are not available to 
user jobs. 


The default values for scheduling priority (PRIORITY), execution priority 
(XPRTY), and multiprogramming limit, are shown in the following table, together 
with the recommended usage. 
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Table 5-3. 


Job Classes: Standard Attributes and Recommended Usage 


Jo Recommended 
Cla Usage 


A-C 
D 1 
E 2 
F 3 
G 4 
H 6 
I 7 
J 6 
K-O 7 
P 7 
Q 0 
R 0 
RA * 
RB 2K 
S) 0 
T 7 
U 0 
Vv 7 
W 0 
x 0 
Y 7 
Z 0 


Fr rR OOCTOCON BN 


* 
* 


oO 


or Ore 


b Default Default Default 
ss | PRIORITY | XPRTY |MAXLOAD 
vs 9 1 


— 
EDORr eee ee HE 
So 


* 
* 


— 
NO 


Ror aD 


atch jobs 

atch jobs 

atch jobs 

atch jobs 

atch jobs 
communications 
GTWRITER 
TDS 

atch jobs 

atch (default) 
OF jobs 
Input readers 
Hardware TD_MVH job 
Mirrored disk REFILL jobs 
TNS and/or FEPS (telecom 
monitoring, QMON for MCS), 
IRAEH, IOSER, ARS, SECCL, 
OCS, SAV_SRV 
File transfers FTF, UFT and 
SERVER2 
IDJP operator's IOF jobs and RBF 
TRCCL (Trace) 


MAIN operator's IOF jobs, LAEH 


* Fixed by OLTD 


User-created Job Classes 


**Fixed by SYSTEM 


These are two-character classes, either created statically by the CONFIG statement 
JBCLASS2, or dynamically created by the operator command START_LOAD. 


Two-character classes (with the exception of the service job class RB) can be 
deleted using the TERMINATE LOAD command. 
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5.3.2 The Job Class Group Concept 
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A Job Class Group (JCG) is a means of organizing a number of usually similar job 
classes into a single manageable entity. Just as job classes are a form of job 
management, JCGs are a form of job class management. 


A JCG can be created dynamically using the command CONNECT_LOAD 
(CNLD). Alternatively, it can be configured at CONFIG time, using the 
JOBCLASS statement (mono-character) or JCLASS2 statement (two-character). 


The connection of a class to a Job Class Group can be changed using the Main 
Operator commands DISCONNECT_LOAD (DISLD), and CONNECT_LOAD 
(CNLD). 


A Job Class Group consists of a 'parent' job class and one or more 'dependent' job 
classes. The group is known by the name and attributes of the parent job class. No 
job class group can be both a parent job class and dependent job class at the same 
time. 


Not all job classes necessarily belong to a Job Class Group, so there may be JCGs, 
dependent JCGs, and independent JCGs. 


The multiprogramming limit of the group is always equal to the multiprogramming 
limit of its 'parent' job class. Thus, if the total number of jobs currently executing in 
the group is equal to the MPL limit of the 'parent' class, no other jobs can be started 
anywhere in the group. 


The operator can prevent jobs of a specified class from being scheduled for 
execution with the TLD (TERMINATE LOAD) command. 


For more information, see the Automatic Resource Management (ARM) User's 
Guide. 
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Table 5-4. Job Class Commands 


DLD DISPLAY LOAD CLASS To display class or class group status 
(started or not), current load, 
multiprogramming level, number of 
scheduled jobs, number of non scheduled 
and non executing jobs, priority default 
values, and whether multiprogramming 
level is modifiable or not. 

SLD START LOAD To make each class available or not for 

TLD TERMINATE LOAD scheduling. No job in class held by TLD 
can start executing unless FJ (Force Job) is 
used. 

MDLD |MODIFY LOAD To modify Multiprogramming Level and 
scheduling and executing priorities, which, 
if not modified, are retained between 
sessions. Not effective on classes of jobs 
already executing. 


MODIFY JOB To alter the class of a job that is held or in 
scheduling. 


DLD DISPLAY LOAD CONNECT |To display all the connections between the 
classes and class groups. 


5.3.3 Priorities 


Three types of priority are used by the system: 


Scheduling Priority controls the order in which jobs are queued while 
waiting to be run. 


Execution Priority controls the availability of CPU time for each job 
(step)while executing (also called Dispatching 
Priority). 

Output Priority controls how and when an output can be processed by 
WRITER. 
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5.3.3.1 Scheduling Priority (SPR) 


This priority is mainly used with job classes to control the order in which jobs are 
queued and selected for scheduling (see Job Class Concept above). 


Jobs are queued in priority order while waiting for translation, scheduling and 
machine resources. Jobs with the same scheduling priority are handled on a first in, 
first out (FIFO) basis. 


The scheduling priority range is from 0 - 7, with 0 being the highest. The fact that a 
job is held or its class is not started does not affect the job's position in the queue 
(apart from jobs leaving the queue to be run or being inserted in the queue). 
Operator commands which involve scheduling priority are as follows: 


Table 5-5. Scheduling Priority Commands 


DISPLAY JOB Display scheduling priorities. 
DISPLAY _SUBMITTER 


MDLD MODIFY LOAD Can be used to change the scheduling 
MDJ MODIFY JOB priority. 


(JCL statement) Used to give an explicit scheduling priority 
to a job. 

ENTER JOB REQUEST Otherwise, a job will assume the default 
priority of its class. 


FORCE JOB Used to place a job at the front of the job 
scheduling queue. 
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5.3.3.2 Execution Priority (XPR) 


This priority controls the sharing of the CPU between executing steps, during 
multiprogramming. Execution priorities are used to streamline step-execution flow 
and thus make the best use of the CPU. 


The XPR range is from 0 - 9 (0 being the highest). GCOS 7 itself has an XPR 
higher than 0 and thus can always gain control of the CPU. 


Operator commands which can affect execution priority are as follows: 


Table 5-6. Execution Priority Commands 


Function 


DISPLAY JOB Display execution priorities 
DISPLAY SUBMITTER 


MODIFY LOAD Alters the execution priority of a class. 
MODIFY JOB To alter the XPR of a job. 


STEP (JCL statement) Used to give a step an explicit dispatching priority. 

EXEC PG |EXEC PG Otherwise it has the default priority of its job class. 
Priorities are developed in further detail in Section 5.10, Automatic Resource 
Management. 


5.3.3.3 Output Priority 


Output Priority (OPR) 


This priority is described in Section 5.8.1.5 Output Priority (OPR). 
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5.3.4 Service Jobs 
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A service job is a job that the system runs in order to execute certain system 
functions. 


Service jobs are not always running, because they provide temporary functions or 
because they need to be active only for certain types of work. 


The following are service jobs: 


Automatic Restore and Save (ARS) 

Interactive Operation Facility (IOF) 

Input Stream Reader (Reader) 

Disk Move Head T&D (TD_MVH) 

Automatic refilling of mirrored disks (REFILL) 
Queue Monitor (QMON) 

Front End Processing Support (FEPS) 

Front End Control and Management (FECM) 
Transport and Network Subsystem (TNS) 
Networking - Remote Administrative Exchange Handler (RAEH) 
Open Communication Subsystem (OCS) 
Input/Output Server for either Large Memory Cache or Mirror Disks or both 
(IOSER) 

DJP File Transfer Server (SERVER2) 

Remote Batch Facility (RBF) 

System Trace (TRCCL) 

JCL Translator (JTRA) 

HA Complex Management Server (CMSR) 

HA Takeover File Recovery (RECOV) 

HA Journal Recovery Utility (JRU) 

Virtual Communications Access Method (VCAM) 
Generalized Transfer Processor (GTP) 

TDS Segment Management (JPPC) 

AUDIT7 Security Server (SECCL) 

Local Administrative Exchange Handler (LAEH) 


High Speed Link Server (HSLV7000) 


All service jobs are assigned a ron (run occurrence number) when introduced to the 
system. The job class is exclusive to that particular service job (See Table 5-7 
Service Jobs). 


There can be only one JTRA job executing at any one time. 


There is one READER job for each device on which Input Reader has been started. 
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Table 5-7. 


7 


FUNCTION 


READER |OPERATOR 


TD MVH_ |OPERATOR  |H MVHEAD 
OPERATOR  |H_ UTILITY 


REFILL 
submitter 
submitter 
submitter 
submitter 
submitter 
submitter 


OCS . 
1) IOSER OPERATOR |H_IOSER 
management 


SERVER2 [submitter 


Resource ARS 

Management 

Security SECCL AUDIT7 
Audit 


System TRCCL OPERATOR 
Trace 


Output WRITER submitter 
Writer 
Dynamic SAVE_SRV|SYSADMIN 


Save Server 
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Service Jobs (1/2) 


LOAD 
MODULE 
NAME USED 
H_IOF plus any 
system or user 
load module 
name 


DEFAULT COMMENTS 
CLASS 


SLD Q 
TLD Q 
MDLD Q multi 
| 

R 

T 

Vv 

Ww 


POSSIBLE 
COMMANDS 


MDLD R multi _ |class R is always 
started 


class S is always 
started 


class S is always 
started 


class S is always 
started 


RA 


SLD T ; TLD T 
H_IOF plus any 
system or user 
load module 
name 

H_ARS 


H_SECCL 


MDLD T multi 


class S is always 
started 


SLD V class V 

TLD V multiprogramming 
level = 1 

MDLD W multi uses IDLE state 
class W is always 
started 


H_TRCCL 

H_WRITER 

H_DFSRD_ SRV SDYNSVR 
DDYNSVR 
TDYNSVR 


SLD U 
TLD U 
MDLD U multi 


B 
S 
S 
S 
S 
S 
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Table 5-7. Service Jobs (2/2) 


FUNCTION LOAD DEFAULT POSSIBLE COMMENTS 
MODULE CLASS COMMANDS 
NAME USED 
H_EXECUTE uses IDLE state 

class X is always 
started. 
class X 
multiprogramming 


H_CMSR 
OPERATOR |H_RECOV 
OPERATOR _|H_RECOV 


OPERATOR Y MDLD Y multi _|class Y is always 
OPERATOR started. 
uses IDLE state 
server for TDS i=1toS5 started 
a a co en ca 
Operator started 


Local LAEH OPERATOR H_OMH Z class Z is always 
Administration started 

Exchange 

Handler 
ee ee ee 
Link server started 


Service jobs do not display log messages concerning run states except in error 
messages. 


Service jobs go through the same states as user jobs, but with certain differences. 


GTP, JTRA and WRITER use a specific state called IDLE. They enter the IDLE 
state when they run out of work. However, as soon as work is available (i.e. 
transfers to be made, jobs to be translated, or outputs to be printed), they 
automatically enter the INSCHEDULING state. The IDLE state economizes the 
use of system resources and removes the need for operator intervention. 


Service-job scheduling is determined by class Scheduling Priority, and the 
multiprogramming limit for that class. It can be limited by the multi-programming 
level of a class group attached to the service class. 
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Service jobs use the scheduling and execution priorities of their class. These can be 
modified by using the following commands: 


Table 5-8. Service Job Commands 


MDLD |MODIFY LOAD Alters the priorities for a class 
(except classes S, U, X Z and RB). 


MDJ MODIFY JOB Alters the priorities for some service jobs 
(e.g. READER and WRITER). 
Most service jobs never wait for scheduling or system resources. If they cannot 


start executing at once, they abort and have to be reintroduced. A message is 
displayed, either on the log or the appropriate terminal, that the job failed to start. 


Some service jobs create an output. If the job aborts, a dump of the job is taken. 
The job remains in the OUT state until the job report and dump have been printed. 


Accounting information for service jobs is stored in the accounting file in the same 
way as for user jobs. 


When dedicated to the Large Memory Cache function, H_IOSER is started by the 
operator command START IO CACHE (SIOC). When the system has been 
configured for Mirror Disks usage (CONFIG MIRROR=YES), H_IOSER is 
automatically started at GCOS READY. 


Refer to Large Memory Cache User's Guide and to Mirror Disks User's Guide for 
further details. 


5.3.5 The Input Reader 


The Input Reader has two main functions: 


e To read the input stream (that is, one or more job or data enclosure descriptions). 


e To translate job descriptions and put them into the INSCHEDULING or HOLD 
state. (Jobs are only put into HOLD, if HOLD was specified as a parameter of 
either the EJR command or the $JOB statement, or as result of a HOLD_JOB 
(HJ) command). 


These two functions are performed by the READER service jobs and the JCL 
translator. 
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5.3.6 Input Stream Introduction 


An input stream may be introduced to the system in one of the following ways: 


e an ENTER JOB REQUEST (EJR) command, 


e "spawning" a job during the execution of another job (by use of the RUN JCL 
statement), 


e from a terminal using either the RBF or IOF service jobs. 


5.3.7 The Reader Service Jobs 


The preceding actions or commands initiate Reader service jobs that read the input 
stream from the specified file or device. 


There may be several Reader service jobs active at the same time although their 
number is limited to the multiprogramming level of job class R to which they 
belong. 


They can read the input stream from either sequential disk or magnetic tape files, 
or a member of a disk library. 


To improve system performance, pre-initialize the load module activated by the 
Reader service jobs. This is done by issuing the command: 


MDC PLM H_ RUN. 
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This Figure gives the first phases of the life of a job. The service jobs active during 
this phase are the INPUT READER and JTRA, (the JCL translator). If translation fails, 
the job is aborted in step 0. After translation, the job is either IN SCHEDULING, or 
possibly HELD, if requested by the HOLD parameter of EJR command, for example. 


Figure 5-3. Job Introduction 
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When a Reader has been initialized, by the EJR command, it proceeds in the 
following way: 


1.  Ifit finds that the specified device contains nothing to read, it issues a 
message asking the operator to mount the volume containing the Input 
Stream. 


2. The Reader then reads the job and data enclosure descriptions and displays a 
message for each input. 


3. When an End of File is encountered, or a TERMINATE SYSTEM command 
is received, the reader stops reading at the end of the job it is currently reading 
and warns the JCL translator that there are jobs to be translated. 
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5.4 Job Introduction 
When a job is introduced the following message is displayed: 
{IN } {ron2 station } 
(INO1)hh.mm ronl { } jmn USER=usernm CLASS=aa SPR=spr { } 
{HOLD} {STATION=station} 
The job is given a ron number by the system at job introduction (ron1). 
If requested, the job is put into HOLD after translation. The job is not started until 
a RELEASE JOB command is issued, or another job executes a RELEASE JCL 
statement. 
Ron2 indicates an input stream spawned by the job ron2 (by the use of RUN JCL 
statement) 
A limit on the number of jobs that the system may know simultaneously is defined 
during configuration. When this limit is reached, the system displays the following 
message: 
IN14 cmdnm dvnm JOB READING STOPPED: JOB MAX. NUMBER 
Aftera TERMINATE SYSTEM command has been issued, new jobs cannot be 
introduced to the system (see Section 3.5 Terminating the Session). 
Service jobs are introduced by specific operator (or terminal user) commands or 
actions. No message is displayed on their introduction. 
5.4.1 Data Enclosure Introduction 
An input stream contains job descriptions and data-enclosure descriptions (defined 
by $DATA and $ENDDATA statements). 
The data enclosure contains data which is picked out from the input stream and 
moved into libraries without any job execution being performed. 
For identification purposes each data enclosure receives a ron, although this again 
causes no job execution. A report is produced only if an incident occurs during its 
introduction, or if specified by the user. 
Once a data enclosure has been introduced the operator loses control over it. 
Each data enclosure introduction displays the message: 
(INO2) hh.mm ron DATA MB=mbname IN USER=Usernm station 
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5.4.2 Operator Dialog During Job Introduction ($SWINPUT JCL Statement) 
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Some jobs may ask for input using the SSWINPUT JCL Statement. This should be 
used with caution and only when the operator is familiar with the jobs which 
require input in this manner. It is advisable, where possible, to use the EJR 
command rather than this feature. 


At JCL introduction time, the reader stops and an input is asked for with the 
following prompt: 


nn/ron text 


where text is taken from the $SWINPUT JCL statement. The operator, taking into 
account the site information, enters: 


nn reply 
The same $SWINPUT JCL statement may issue several prompts to the operator. 


Two forms of $SWINPUT JCL statements are available: 


The first (which uses the ANSWERS parameter) normally asks for a single reply. 
The reply must belong to a user-defined list of possible replies. If a wrong reply is 
given then the prompt is displayed again. After three unsatisfactory answers the 
user job aborts with relevant diagnostics in the JOR. 


EXAMPLE: 


15/X25 TYPE 1 IF UPDATE, 2 IF CREATION 
Q) 


The second form of $SWINPUT JCL statement asks for input from the operator 
until a user-defined reply terminates the process. (END parameter of $SWINPUT.) 


This second form should be used only in exceptional circumstances, for instance, to 
enter JCL using a main operator console as a rescue operating mode when the input 
device is out of order, or if the person at the operator console is the author of the 
job. It is recommended that the user-defined prompts to the operator specify clearly 
how to terminate the process, or that some common conventions are used on site. 
After this input has been sent to the user job, the reader resumes reading. 


If the operator has not received clear guidance, or if the user prompts are not clear, 
he may terminate the reader using a TERMINATE_INPUT_READER (TIR) 
command with the STRONG option if the job was submitted by 
START_INPUT_READER (SIR). If the job was submitted by an 

ENTER _JOB_ REQUEST (EJR) with a $SWINPUT, he should first display 
information about the jobset request using the DISPLAY USER REQUEST 
(DUR) ALL usernm command, giving a Jobset Occurrence number, Jxxxx. He may 
terminate the reader using CANCEL USER REQUEST (CUR) Jxxxx. 
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5.4.3 


5.4.4 
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The JCL Translator 


The JCL Translator (JTRA) : The JCL Translator is one of the system service jobs. 
It is always known to the system; it does not terminate but enters the IDLE state. 
Only one JTRA can be known to the system at any one time. 


The JTRA uses class X and it always has a Scheduling Priority of 0. 


The JTRA is activated whenever there is an INTRODUCED job present. If more 
jobs are INTRODUCED while the JTRA is executing, these are also translated in 
turn, before JT[RA enters the IDLE state. 


If, after a Warm Restart, there are non-translated jobs in the INTRODUCED state, 
they cause JTRA to enter the INSCHEDULING state and then they are translated. 


After translation JTRA puts the jobs into the scheduling queue; they go either into 
the HOLD state or into the IN SCHEDULING state, depending upon the job 
description. 


JTRA does not normally display messages or generate an output. Occasionally 
messages with a key of "TNnn" may be output, these should be referred to the 
Service Center. Users may cause a message to be displayed at translation by use of 
the MESSAGE JCL statement. 


If during translation, a JCL error is discovered or a JCL "INVOKED" volume is not 
ready or is being used by another job, the job in error aborts. Log messages tell the 
operator when a job has aborted. Refer to the Console Messages Directory for the 
corrective actions. To improve system performance the load module activated by 
the JTRA service job should be pre-initialized using the command: 


MDC PLM H EXECUTE 


Hold State 


After introduction and before execution, a job can be put into the HOLD state. 
While in this state the job cannot be started unless a RELEASE JOB command 
(RJ), or a FORCE JOB command (FJ) is used. 


A job can be placed in the HOLD state on introduction by use of the HOLD 
parameter in the $JOB JCL statement or with the HOLD parameter in the EJR 
command. While the job is in the IN SCHEDULING state the operator can use the 
HOLD_JOB (HJ) command to put a job or all the jobs into the HOLD state after 
their translation: 


HJ ronlist 


When the list of run occurrence numbers (rons) is omitted, all jobs not executing 
are held. 
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A job can be put back to the INSCHEDULING state by the operator using the 
RELEASE JOB (RJ) command or by a job executing a RELEASE JCL statement: 


RJ ronlist [STRONG] 


When the list of run occurrence numbers is omitted, all held or suspended jobs are 
released. 


NOTES: 
The HOLD parameter in the $JOB JCL statement may be used in two different 
ways: 


If HOLD is used as a Self Identifying Value, the job is normally released by the 
operator using an RJ command or by another job using a RELEASE JCL 
statement. 


If HOLD is used as a keyword, it specifies a hold-count (HOLD=hold-count), 
and it is assumed that the user has introduced a series of jobs and that he wants 
control of the synchronization of these jobs, without any operator intervention. 
Each time a RELEASE JCL Statement is used upon that job the current hold 
count is decrement by one, and when it reaches zero value the job is put into the 
IN SCHEDULING state. To prevent manipulation errors, jobs using the hold- 
count facility may not be released by the operator unless a RJ ron STRONG 
command has been issued, except if the current hold-count is one. Hold-count is 
decreased by one with the RJ command or the RELEASE JCL statement. 
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5.5 Job Scheduling 


Whenever a job terminates or a new job is introduced, the system tries to start 
another job. Jobs in the IN SCHEDULING state are queued for selection in 
scheduling priority order and on a FIFO basis for jobs of the same priority. 
The system tries to start the first job in the scheduling queue provided that the 
following conditions are satisfied: 


e The job is not in the HOLD state and its associated job class and group class, if 
they exist, are started. 


e The multiprogramming limit for that class has not been reached. 


e The multiprogramming limit of any class group attached to the job has not been 
reached. 


e The system multiprogramming level has not been reached. 
e The user batch job limit has not been reached. 


If the first job in the queue cannot start then the system tries to start the next job, 
and so on. This is repeated until no more jobs can start due to the above limitations, 
or because no more jobs are waiting to be started. 


A job can be selected immediately with the use of the FORCE_JOB command (FJ). 
This job is said to be forced. 


Forced jobs ignore all restrictions except for the maximum number of started jobs 
(which is set at configuration time). Thus a forced job may overload the class 
multiprogramming and the class group multiprogramming levels. In this case no 
new jobs, dependent upon these levels, start until the levels return to their normal 
limits. 


User jobs display the following message when they start: 
(JB01) hh.mm ron STARTED jnm usernm jclass 


Service jobs do not display any message, except for the service job which manages 
a main operator console. 


Operator commands concerning job scheduling are as follows: 


Table 5-9. Job Scheduling Commands 


DISPLAY _JOB SCH Display the order of jobs waiting to be started. 
DISPLAY SUBMITTER 


SCH 


MODIFY JOB To alter this waiting order. 
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In summary, job scheduling tests the following relations: 


1. Total number of executing and suspended jobs (both service and user) is less 
than or equal to the maximum number of jobs. 


2. Class group load is less than the class group multiprogramming level. 
3. Class load is less than the class multiprogramming level. 

Service jobs ignore case 2. 

Forced jobs ignore cases 2 and 3. 

The priorities are: 

1. Forced jobs 

2. Released suspended jobs 

3. Other jobs. 
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5.6 Job Execution 


Once started, the execution of a job proceeds sequentially through the JCL 
statements (unless the user, using JUMP statements, has requested some 
alternative). 


The main part of the job execution is the execution of steps, but the user may: 


e Introduce new jobs by using RUN JCL statements, which have the same 
function as the ENTER JOB REQUEST (EJR) command. 


e Release jobs in the HOLD state by using the JCL statement, RELEASE. 


e Send messages to the operator by using the SEND JCL statement. These 
messages are also shown in the corresponding Job Report (JOR or JOB_REP). 
These messages appear in the format: 


SP06 ron msg-txt 
e Execute operator commands as if the EXDIR statement were entered from the 
console using GCL statements. 


Finally the job execution terminates. 


5.6.1 Events Occurring During Job Execution 


An event occurring during job execution normally is caused by a device or volume. 
Other events occurring during execution are reported to the user in the Job Report 
(prepared by the system). 

Occasionally intervention from the operator is required and, when this is the case, 
he receives console messages to that effect. However some console messages are 
purely for information and do not require any operation action. 


The rest of this Section (5.6) deals with the components of a job run and, where 
appropriate, certain possible events are also described. 
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5.6.2 Step Execution 
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1. 


Resources are needed for each step to be executed. The job may be queued to 
wait for a resource, in which case one of the following messages is displayed: 


1) A file is being used by another job and cannot be shared: 
DFO1 ron FILE efn volnm USED BY: ronl, ron2, 
RSO04 ron.ssn WAITS FOR FILE efn ON dvnm 


A job, having the Run Occurrence Number ron waits for a file which is being 
used by jobs ron], ron2, ... 


2) (Coupled systems): the dual sharing conditions of the file "efn" on a 
resident volume do not allow access to it: 


RSO4 ron.ssn WAITS FOR DUAL SHARING OF FILE efn ON volnm 

The corresponding job remains in the WAITING state and is reactivated when 
the dual sharing conditions change on the other system. 

DFO2 ron WAITS FOR FILE efn RSDT FOR DUAL SHARING CONDITIONS 
The DF02 message is displayed when the RS04 message has been displayed 
on the other system. 


3) A volume identified by its name (volnm) and characteristics (dvtyp, dvattr, 
labeltyp) is not available. It is either: 


a) being used by another job and cannot be shared, or 
b) it is a non-removable disk that is OUT or is incorrectly identified, with the 
result that the step is waiting for a disk that does not exist. 


Check dvattr and labeltyp. The label type is specified only if volume labels 
are non-standard (SNSTD). 


RSO04 ron.ssn WAITS FOR VOLUME volnm:dvtyp [/dvattr] [labeltyp] 


4) A device is needed and none is currently free: 


RSO04 ron.ssn WAITS FOR DEVICE dvnm 


5) More resources are needed in the dimension than are currently available: 
RS04 ron.ssn WAITS FOR MPL IN DIMENSION dimname 
6) The step initiation is waiting for a process to be allocated to it. (The 


maximum number of active processes is decided at system configuration 
time): 


RSO4 ron.ssn WAITS FOR PROCESS 


7) Not enough free space exists on the backing-store file to load the step: 


RSO4 ron.ssn WAITS FOR LOADING 
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8) Too many sequence processes are loading non pre-initialized Load 
Modules simultaneously: 


RSO4 ron.ssn WAITS FOR LOADING PROCESS 


9) Before Journal is currently fully used: 
RS04 ron.ssn WAITS FOR BEFORE JOURNAL 


10) Ina DJP environment, the ron is waiting for a remote site: 

RSO4 ron.ssn WAITS FOR SITE sitenm 

11) No more resources for non-pre-initialized Load Modules are currently 
available: 


RSO4 ron.ssn WAITS FOR NON PREINITIALIZED LOAD MODULE RESOURCE 


12) In DJP environment, the ron is waiting for a remote file: 


RSO04 ron.ssn WAITS FOR REMOTE FILE efn ON volnm 


13) In DJP environment, the server is not available: 
RSO4 ron.ssn WAITS FOR TELECOM SERVER tsvrnm 


2. The list of jobs waiting for resources can be displayed by using the DJ or DS 
command. 


As soon as the resource becomes available, the message: 
RSO6 ron REACTIVATED 


is displayed and step execution proceeds. No operator intervention is 
necessary. 


3. The operator can however react to the conflict indicated by message RS04 in 
various ways. He may: 


Prevent other jobs from entering the resource conflict. 

Suspend or terminate one of the jobs in conflict, if the conflict is found to be 
abnormal. This is done by using the MODIFY_LOAD, MODIFY_JOB, 
HOLD_JOB or CANCEL_JOB commands described in Section 7. 


4. Volume mounting may also be requested and execution waits for these 
mounting operations to be completed before proceeding. 
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The execution of each step may also cause events such as: 
Creation of an operator command: 


OP04 ron.ssn COMMAND: cmdnm CREATED 


Deletion of a previously created operator command: 

OPO05 ron.ssn COMMAND: cmdnm DELETED 

Printing of a user message or question. These messages are stamped with the 
ron of the job: 

hh.mm USER ron message-text 

Transformation of a work tape into a normal tape (in particular in the case of 
dynamic extension of a tape file): 

FPO1 dvnm ron.ssn TAG volnm FOR EFN efn 

The step execution can be temporarily suspended by using the HOLD_JOB 
(HJ) command (see Section 5.6.6 Suspended Jobs below). 


If requested by an SLD command the following message is displayed when 
each step starts to execute: 


JB08 ron.ssn STEP Im-nm XPR=xpr J=jnb 
If the step execution terminates normally, the job execution proceeds. If it 
terminates abnormally, the job is aborted, unless the step has been declared as 


being repeatable (particularly with checkpoint restart) or the user has used 
JUMP JCL statements to take care of the situation. 
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5.6.3 Step Job Repeat 


If a step terminates abnormally and it has been declared as being repeatable, the 
following question is asked (with a deferred reply): 


[KILLED ] 
] 1lm-nm [SEV sevnb] [statustp] [ REPEAT] 
[ABORTED] 


(SPO7) hh.mm ron.ssn [ 


[FROM CHECKPOINT ckptnb] {y|N|}, DEFAULT=Y 


XX 


REPEAT 


ckptnb 


SEV sevnb status 


NOTE: 


if the deferred reply code must be used in the reply. 


In the case of a system crash, the repeat question is 
sent to the system operator during warm restart. If 
there is no crash, this question is sent to IOF users with 
an abnormal job termination. If the IOF user has been 
disconnected, the job aborts, otherwise the option 
functions as follows: 


— if the user has declared the execution of the step as 
repeatable, execution is resumed from the beginning 
of the step. 


— if the step is not declared repeatable but the job is 
repeatable, execution is resumed from the beginning 
of the job. 


— if a checkpoint is declared, execution is resumed 
from the indicated checkpoint. 


if checkpoints were taken during the last execution of 
the step ckptnb indicates the number of the last 
checkpoint taken. Checkpoint 0 indicates the 
beginning of the step. 


sevnb indicates the severity of the step abort and status 
indicates the origin. These are summarized in the table 
below. 


The ROLLBACK question is no longer asked; the rollback is automatic if a 


Before Journal is used. 
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Table 5-10. | Step Abort; Severities and their Causes 


Meaning (when set by GCOS 7) 


SEV3 10000-19999 User Error 


SEV4 20000-49999 System Error (e.g. system overload) 


SEV5 50000-59999 (CJ) (the operator did not specify STRONG in the 
CANCEL JOB command) 


SEV6 60000 System Crash 
SEV7 "8000" X System file error (probably I/O error) 


Possible replies: 


YES The execution of the job or the step is repeated from 
the indicated checkpoint. If the step was not declared 
as being repeatable, only the journal rollback takes 
place. 


NO The step execution is not restarted; a journal rollback 
takes place if the step was under GAC (Generalized 
Access Control) or if use of the file or communication 
queue has been requested. In most cases the job is 
aborted unless the user has used JUMP statements, 
which cause the job execution to be resumed. 


Any other reply is incorrect causing the question to be repeated. 


Ifa HOLD_JOB (HJ) command is issued on the job before replying YES, the job is 
suspended after rollback of the journal, if rollback is applicable. 


If the step abort is due to an I/O error (a message would have been displayed), 
check the volume and device (tape or disk) before replying. If necessary, mount the 
volume on another device before replying. 
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5.6.4 
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Pre-initialized Load Modules 


Load modules (or "programs") can be transferred to a permanent BKST file. They 
are then said to be pre-initialized. This speeds up the loading of the load module 
when it is requested for execution in a job step. When a load module has been 
pre-initialized, the original copy (in a load module library) is not used. 


NOTE: 
Pre-initialized Load Modules are lost if a RESTART (CLEAN) is performed. 


It is the operator's responsibility to manage a permanent BKST file: 


e To find out which load modules are pre-initialized, using the 
DISPLAY CONFIGURATION (DC PLM) command. 


e To pre-initialize a load module, using the MODIFY CONFIGURATION (MDC 
PLM) command. 


e To delete a load module from a permanent BKST file, using the 
MODIFY _CONFIGURATION (MDC CLM) command. 


The DC PLM, MDC PLM, and MDC CLM commands are described in detail in 
Section 7. 


Data Management Utilities are used very often, so you may wish to pre-initialize 
them. The following table gives the correspondence between each utility and the 
load module it executes: 


Utility Load Module 

FILREST Before TS7254: H_DFSRD_ LM 

FILSAVE From TS7254: H_UTILITY 

VOLREST Before TS7254: 

VOLSAVE If FAST option H DFSRD IM 

Else H_UTILITY 

From TS7254: H_UTILITY 

VOLPREP H_VOLPREPARE 

VOLMODIF 

SORTIDX H_SORTIDX LS 

TAPEPREP H_PRTP 


All other Data Management Utilities execute the load module H_UTILITY. 
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5.6.5 SYSOUT Overflow 
QU13 ron.ssn SYS.OUT OVERFLOW 


This message indicates that the specified step of the job was unable to write to the 
SYS.OUT file as it was full and could not be extended (message OU25). 


If outputs can be processed by the Output Writer this message is only a warning; 
the step resumes its execution, without any operator intervention, when some space 
becomes available. 


Sometimes operator intervention is required: 


e To find out the current contents of the SYS.OUT file by using the 
DISPLAY LOAD OUTPUT SPACE command. 


e To issue a START _OUTPUT_WRITER command on classes and devices for 
which outputs are waiting. 


e To use the RELEASE OUTPUT command with the STRONG parameter on 
outputs in the READY or HOLD state. 


e To prevent other jobs from generating outputs by using the HOLD_JOB (HJ), 
MODIFY_LOAD (MDLD), MODIFY_JOB (MDJ), CANCEL _JOB (CJ) 
commands as appropriate. 


e Under certain circumstances (e.g. printer failure) the Output Writer should be 
started on a tape file to free SYS.OUT space using the 
START OUTPUT WRITER (SOW) command. The tape may then be printed 
later using the GCL command DPRINT. 


NOTE: 
It is possible to prevent a step from using too much SYS.OUT space by use of 
the LINES parameter of the STEP JCL statement. Action should be taken to 
prevent SYS.OUT overflow from happening again; e.g. submit jobs in a 
different order, use private SYS.OUT files, correct a possible endless loop in a 
program. 
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5.6.6 Suspended Jobs 


Executing jobs can be suspended using the HOLD_JOB (HJ) command: 


HJ [ronlist [ENDSTEP] ] 


If the ENDSTEP parameter is used, the job is suspended at the end of the current 
step. 


Suspending a job prevents any further execution of the job. 
Suspending a job does not lower either the system or class load. 


If the job is suspended at the beginning or in the middle of a step, before devices 
have been allocated, no device(s) are allocated. 


Swappable memory is also freed when a job is suspended, but other memory such 
as I/O buffers is not. 


When a job is suspended between steps, it frees all resources except "passed" files. 


A suspended job can be released by the RELEASE JOB (RJ) command. When a 
job is released it starts to execute immediately, in accordance with its Execution 
Priority. 


Service jobs should not be suspended except under exceptional circumstances. 
JTRA cannot be suspended. 


NOTES: 


1. The TERMINATE SYSTEM (TSYS) command is not effective until all 
suspended jobs are released. 


2. Jobs can be suspended or released by the system (see Section 5.9 
Automatic Resource Management (ARM)). 
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Before Journal 


The Before Journal is a disk-based system file containing all information needed to 
ensure the integrity of the journalized files. This file is used to restore a user's file 
to its previous state (last checkpoint, last commitment unit, beginning of the step) 
after a step abort or a system crash. The use of the Before Journal is not normally 
visible to the operator except when the file becomes full and the application 
programmer has not previously given a list of media (same device class as the 
volume supporting SYS.JRNAL) on which to extend the file. In these 
circumstances, the following message is displayed: 


JLO2 ron MORE SPACE NEEDED FOR BEFORE JOURNAL. WHERE? 
There are three possible answers: 


volnm the operator replies with the name of a disk with room 
for the file extension and the job continues. The extra 
area used is freed when the job or step terminates. 


NO this is the normal reply if no more space is available. 
The step is aborted. 


CONTINUE if the operator replies CONTINUE, the job continues, 
but it does so as if no checkpointing has been used. 
This reply should only be used with the user's express 
permission. CONTINUE is not a valid reply if the step 
concerned is under GAC (Generalized Access 
Control). In such a case, the reply CONTINUE is 
ignored and the message JLO2 appears again; the only 
possible answers are volnm or NO. 


If the extension is not possible on the specified disk, the following message is 
received: 


JLO3 ron EXTENSION ON volnm NOT POSSIBLE [RC = retcode] 
and the JLO2 message is repeated. 


If an I/O error occurs on the Before Journal, thus making its further use impossible, 
the following message is sent to the step submitter (who may be the main 
operator): 


JLO5 ron BEFORE JOURNAL I/0 ERROR. CONTINUE? 
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Possible replies are: 


NO This is the normal response which aborts the step. This 
is the default, assumed when the step submitter is not 
connected. 

YES With this response, the job continues without the 


Before Journal. 
If no Before Journal exists, the following message is sent to the step submitter: 
JLO6 ron SYSTEM WITHOUT BEFORE JOURNAL. CONTINUE? 
In this case, the step submitter must answer YES or NO: 
YES Causes the step to continue without the Before Journal. 


NO Aborts the step. This is the default, assumed when the 
step submitter is not connected. 


TDS uses the Before Journal in a slightly different manner. The part of the Before 
Journal used by a TDS is an additional journal file dedicated to this TDS which 
resides on | to 4 disks. After each TDS generation, if the Before Journal location 
was not specified in the JCL, the following message is sent to the step submitter if 
he is connected, if not to the main operator: 


JLO7 ron SPACE NEEDED FOR BEFORE JOURNAL FOR TDS tdsnm WHERE? 
The answers are: 


VOL-LST This specifies a list of up to 4 disk names and an 
optional dvc parameter. The dvc parameter is used to 
specify the device class of the disks if it is different 
from the device class of the media used for the 
SYS.JRNAL Before Journal file. 


VOL-LST = volnml [volnm2 [volnm3 [volnm4]]] [dvc] 


NO This is the normal reply if no more space is available. 
The TDS session is aborted. 


If insufficient space is available on one of the indicated disks of VOL-LST, the 
message: 


JLO8 ron SPACE ALLOCATION ON vol-lst NOT POSSIBLE 
[RC = retcode] 


is received and the JLO7 message is repeated. 
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When you change the media on a TDS warm restart, the following message is sent 
to the step submitter: 


JLO9 ron BEFORE JOURNAL FOR TDS tdsnm ON vol-1st? 
The two possible answers are: 


YES This is the normal reply; the same volume is used as 
in the previous session of this TDS. It is also the 
default, assumed if the step submitter is not connected. 


NO To change the volume name for the Before Journal. 
Question JL07 is repeated to ask which volume name 
is to be used. 


Journalization Advanced Service (JAS) and the After Journal 


The Journalization Advanced Service (JAS) and the After Journal are magnetic 
tape or disk files which are used for restoring a file's updated contents from a 
previous copy (save) after a failure. It is also used dynamically by a Transaction 
Driven System (TDS) to handle unsuccessful transactions after an abort or a system 
crash. The disks or tapes used for the journal are normally specified in the 
MAINTAIN_JAS utility which provides the facilities for their maintenance. The 
system Administrator can use MAINTAIN_JAS to extend the volumes used by the 
journal. 


NOTE: 
MAINTAIN_JAS replaces the JAGEN utility of GCOS 7-V5 and earlier 
releases. 


The Journalization Advanced Service (JAS) protects the contents of a user file 
against loss by: 


e Rolling back the incomplete file recovery units and rolling forward the file 
recovery units to be completed. 


e Rolling forward destroyed user files using the ROLLFWD utility in conjunction 
with SAVE and RESTORE operations. 


JAS protects user files by immediate update with the Before Journal, by deferred 
update and the After Journal. The After Journal should be used for protection 
against hardware or recovery incidents. 
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The use of the After Journal requests the mounting of volumes for ron X1, i.e. for 
the system. They must be satisfied prior to other mounting requests, since they may 
impact all jobs using the after journal. Each time a volume is used for the journal, a 
message is displayed to show which is the current and next volume allowing the 
operator to prepare or pre-mount the next volume to save time at the next 
switching: 


JP12 jas name: AFTER JOURNAL IS ON MEDIUM cur_volnm_ name 
CURRENT AFTER JOURNAL FILE IS efn 
NEXT MEDIUM WILL BE next _volnm_name 


When the media list is exhausted, the following message is displayed: 


JP13 jas name: AFTER JOURNAL IS ON MEDIUM cur_volnm_ name 
CURRENT AFTER JOURNAL FILE IS efn 
WARNING: LAST MEDIUM. 


It is advisable to run the MAINTAIN JAS utility as soon as possible to enter a new 
volume list, or extend the existing volume list. See the File Recovery Facilities 
User Guide. 


When the jas-name.JADIR directory is almost full, the message: 


JP22 jas name:THE SYS.JADIR DIRECTORY FILE IS ALMOST FULL. 
ANY NEW JOURNALIZING ACTION WILL ABORT 
DELETE IT AND CREATE IT LARGER 


is displayed. Every step using the After Journal is aborted. 


NoTE: 
When the After Journal is used, ensure that the system date is accurate because 
discrepancies between the system date and last After Journal use are checked. 


Two situations may occur: 


e Predating 


The system date is earlier than the last After Journal date. In this case the 
following message is displayed: 


JP31 jas name: WARNING: PREDATING: 
LAST RECORDED AFTER JOURNAL DATE: date or time 
FUTURE ROLLFORWARDS ARE NOT GUARANTEED, 
CONTINUE? (Y,N) 


The consequence of a predating situation is that some files may not be restored 
to the correct state (this operation is called a rollforward). 
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e Postdating 


The system date is later than the last After Journal use. The consequence of a 
postdating situation is that it may cause a predating at the next session when a 
correct date is given. This is a normal situation, but if one work day has passed 
since the last use of the After Journal, the system detects inconsistency in the 
date. 


If the system date is considered to be incorrect, reply NO to this question. NO 
aborts the step which was trying to use the After Journal. Terminate the system 
and perform ISL again, to provide the correct system date, as soon as possible. 


NOTES: 
From the GCOS 7-V6 release: 


1. The MAINTAIN _JAS utility replaces JAGEN and the message key JP 
replaces JA. 


2. The operator can use the DISPLAY JAS command to display all the steps 
connected to a JAS, meaning all steps that use files protected by a JAS. 
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5.7 Job Termination 


Whenever a user job terminates, the following message is displayed: 


{COMPLETED } 
(JB02) hh.mm ron.ssn {ABORTED } jnm usernm jclass [SEV sevnb] 
{KILLED } 
COMPLETED the job has been executed and terminated normally. 
ABORTED means that the job has been aborted for one of the 


following reasons: 


— A fatal error was found in the job description during 
translation. 

— An abnormal condition occurred during execution. 

— ACANCEL_ REQUEST command was used to 
reply to a system request for a certain device or 


volume. 
SEV sevnb indicates the severity of the step termination. 
KILLED means that the job has been terminated by the 
CANCEL JOB (CJ) command which is described in 
Section 7. 


NoTE: 
Service jobs do not normally display this message. 


When a job is terminated it does not disappear from the system until all its outputs 
have been processed by the Output Writer. 


When a job is terminated, GCOS 7 looks for another job to run, unless a 
TERMINATE SYSTEM command has been issued. 


If no jobs can start (1.e. there are no jobs in the IN SCHEDULING state) and there 
are no more jobs executing, the following message is displayed: 


(SHO6) hh.mm GCOS: NO MORE JOBS RUNNING 


More jobs should be introduced or made available for scheduling, unless the 
operator wants an empty machine for a specific reason. 


5-40 47 A2 53US 


Running User Jobs under GCOS 7 


5.8 Output Writer 
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During a job run various outputs are prepared for printing. Instead of printing these 
outputs directly the standard method is to store them on an intermediate file. This 
allows more jobs to be run simultaneously than there are printers on the site. It 
leads to a more efficient use of CPU time and of the printers. 


The Output Writer is part of GCOS 7 and is in control of selecting outputs for 
printing, and printing them via the WRITER service job. 


When all of a job's outputs are printed the job is no longer known to GCOS 7, and 
the Output Writer displays the following message: 


(0OU14) hh.mm ron OUTPUT COMPLETED jnm usernm 


The Output Writer may also be started on a sequential tape or disk file instead of a 
printer. Each output is considered as being printed as soon as it has been transferred 
to the file. A file created in this manner can be printed later by a job using the 
WRITER JCL statement or the GCL command DPRINT. 


The maximum number of outputs for a job that can be known to the Output Writer 
is 254. A job can produce more than 254 outputs while it is running, since outputs 
that have been printed are deleted. 


Certain outputs created by jobs introduced via the RBF (Remote Batch Facility) are 
sent back to the issuing station and not printed on the main site. These "special" 
outputs are handled by remote writers and sent to the remote devices or files. The 
maximum number of started writer jobs is 57. 


Their number may be limited by the multiprogramming level of jclass W. 


With the DJP facility (Distributed Job Processing), output may be directed or 
spooled towards other DPS 7000 or DPS 6000 sites, using a WRITER started on a 


remote file or a GTP service job. They are managed and selected in the same way 
as other writers. 
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5.8.1 Outputs 


5.8.1.1. Standard and Permanent Outputs 


An output which is waiting to be printed can be stored in either the system file 
SYS.OUT or in a permanent file - temporary user files are not permitted. In the 
first case the output is said to be standard and in the second to be permanent. 


Once a standard output is printed, the area it used in SYS.OUT is freed. Since all 
jobs producing standard outputs share the SYS.OUT file an overflow condition 
may arise (see "Sysout Overflow", 5.6.5 above). Permanent outputs may be on 
non-resident volumes, tape or disk, and a mounting request is issued if necessary. 
Permanent outputs are not erased when they are printed and can be printed again by 
use of the WRITER JCL statement or the GCL command DPRINT, unless the 
DELETE option is used. 


5.8.1.2 Output Names and Sequence Numbers 


Outputs created by a job may have a specific name given by the user and they are 
also given a sequence number (within the ron) by GCOS 7. Therefore the naming 
of an output can take one or both of the following forms: 


X17:TRUC 
(ron:ounm) 


X17:1 
(ron:ouseqnb) 


X17:2 
(ron:ouseqnb) 
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An output name (ounm) has been given by the user. 
NOTE: avoid giving the same name to several outputs of 
the same job, as commands such as CO X17:TRUC only 
affect the first output encountered by the system 


This output is the JOR or JOB REP (Job Output Report) 
in which all the information concerning the execution of 
the job is given. 

This report is a virtual memory file printed by the Output 
Writer. Even though it is one of the outputs, it is not a 
member of the SYS.OUT file and it is not in SYS.OUT 
format. 

Do not confuse X17:1 and X17.1 ! (X17.1 is the execution 
of step 1 of job X17. Refer to "Job execution" Section in 
this section for further information). 


This output is the JOB_OUT, and contains all the output 
of job using the same output characteristics as JOB REP 
(media, class and priority).X17:2 may contain outputs 
from several different steps of X17. 
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X17:3 This is an output with different output characteristics from 
the JOB_OUT. 
X17:DUMP._ 3 Some cases (especially for service jobs dumps) dumps are 


identified in this way. 


( Introduction > 


You can read meanings of 


KNOWN, READY, WAIT, etc 
Introduced on next page. 


© Translation > 


IN TE 


yar att “ ae os, 
© Selection 


EXECUTING 


CHO STRONG > 


Cae mee / Output unknown ~ 
\ Termination “to System ~~ 


Vv 


* HOLD OUTPUT command 
RELEASE_OUTPUT command 


CUnknown to System » 


Figure 5-4. Output States 


47 A2 53US 5-43 


GCOS 7 System Operator's Guide 


5.8.1.3 Output States 


KNOWN the life of an output begins when first created by a job. 
From this time until it is printed by the Output Writer, 
the output is known by the system. 


READY when the job closes the output file it is then said to be 
READY. However, it is not yet eligible for selection by 
the Output Writer. 


WAIT as soon as the "when condition" indicated in the JCL 
statements is met the output enters the WAIT state; it is 
then eligible for selection to be processed by the 
Output Writer. The "when condition" can be the end of 
job (which is the default), end of step, closing of the 
file. 


If the HOLDOUT parameter is used with the EJR 
command or on the $JOB command line, all the 
outputs for that job remain in the HOLD state when 
the "when condition" is met. These outputs remain in 
the HOLD state until released by the 

RELEASE OUTPUT (RO) command. 


OUT while the output is actually being processed by the 
WRITER service job (i.e. printing ) it is in the OUT 
state. At the end of this operation the output is no 
longer known to the system. 


HOLD an output can be put into the HOLD state by the 
HOLD OUTPUT (HO) command, or by using the 
HOLD parameter in the EJR command. An output in 
the HOLD state is not selected until a 
RELEASE OUTPUT (RO) command is issued. An 
output that is being processed can be put into the 
HOLD state by use of the HO STRONG command, 
and question QU02 is then asked (see 
HOLD_OUTPUT (HO) command). 


WTFL this is the "Wait for File" status. It is indicated after a 
DISPLAY OUTPUT QUEUE command when an 
output has been selected by the OUTPUT WRITER 
but the input file for it cannot be accessed. When the 
input file is freed, the status of this output is 
automatically changed to WAIT and it is then printed. 


Note that a DISPLAY_OUTPUT xron command does 
not return WTFL, but WAIT in the same situation. 
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SCAND means that an output is in a scanned state, that is to say 
the result of scanning by the SCANNER processor. It 
is the response to a DISPLAY OUTPUT 
OUTPUT=output | ron command. After scanning, the 
state is that requested by the user. 

While an output is in the SCAND state, a 

CANCEL OUTPUT, RELEASE OUTPUT, or 
FORCE OUTPUT command will be rejected. 

When an output is processed by the SCANNER 
processor, it is automatically held at the start of 
scanning. It is therefore in the HOLD state as far as 
OUTPUT WRITER is concerned, so a 

DISPLAY OUTPUT STATE=QUEUE | HOLD 
command shows this output in the HOLD state if it is 
enqueued. 


5.8.1.4 Output Commands 


Table 5-11. Output Commands 


OUTPUT COMMANDS MEANING 


CANCEL OUTPUT (CO) cancels the notification to the Output Writer 


to process one or several outputs. 


DISPLAY CONFIGURATION 
[OUTDV] [OUTCLASS] 
DISPLAY LOAD [OUTPUT] 
[ALLOUT] 
DISPLAY OUTPUT (DO) 


FORCE OUTPUT (FO) 


HOLD OUTPUT (HO) 
MODIFY OUTPUT (MDO, MO) 


RELEASE OUTPUT (RO) 


START OUTPUT WRITER 
(SOW) 
TERMINATE OUTPUT WRITER 
(TOW) 


displays software information on the status of 
selected output devices, or output classes. 
displays selected information on the current 
output load. 

displays the state of outputs, output queues, 
and output devices. 

positions a specified output as the first to be 
treated. 

puts a specified output or outputs into HOLD. 
modifies one or several characteristics, such 
as output classes, priorities, destinations, and 
number of copies. 

makes one or several outputs available for 
processing. 

starts the Output Writer on devices or files. 


terminates the Output Writer on devices or 
files. 


For full information on the relevant commands, see Section 7 Description of the 
Operator Commands. 
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5.8.1.5 Output Priorities (OPR) 


Outputs are assigned priorities in the same way that jobs are assigned Scheduling 
Priorities. The OPR is used to queue outputs waiting to be processed by the 
WRITER service job. 


Output Priorities are in the range of 0 - 7, with 0 being the highest. The outputs are 
queued in priority order and on a FIFO basis for the same priority. Outputs waiting 
to be processed are said to be in the WAIT state. 


Output Priorities are either given explicitly in the job description or implicitly by 
default in relation to the output class. Operator commands affecting output 
priorities are as follows. 


Table 5-12. Output Priority Commands 


1DO | DISPLAY OUTPUT displays output priorities. 


MODIFY OUTPUT modifies output priorities. 
(MO) 


5.8.1.6 Output Class (OC) 


There are 26 Output Classes in the range of A - Z. These are used to control outputs 
in the same way that Job classes are used to control jobs. 


Each Output Class has a default output priority and a default output media at 
system configuration time. Operator commands affecting output class priorities are 
as follows: 


Table 5-13. | Output Class Priority Commands 


DISPLAY_CONFIGURATION | displays output class priority and the 
started writers in the specified or 


submitter station. 


MDC OC | MODIFY CONFIGURATION | modifies default priority of an output 
class. 
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The class of an output can be given explicitly in the job description. If not, then a 
default class is assumed. The class to be used as default is specified by the 
CONFIG job. Operator commands affecting output classes are as follows: 


Table 5-14. Output Class Commands 


|DO | DISPLAY_OUTPUT to see the details of an output. 


MDO_ | MODIFY OUTPUT to change the class of output. 
(MO) 


Each Output Class can be started or terminated on each output device. It is also 
possible to start more than one class on a device. This is the usual case (see 
START _OUTPUT_WRITER and TERMINATE OUTPUT_WRITER commands 
in Section 8 Description of the Operator Commands). 


If at system configuration no values are specified, the following default values are 
assumed by GCOS 7: 


OUTPUT CLASS -ABCDEF-@Z 
|---> CLASS "C" IS THE DEFAULT CLASS 
OUTPUT PRIORITY - 12345 6 


OUTPUT MEDIA - I10000 


NoTE: 
Double-letter class (AA...ZZ) do not apply to outputs, but only to job classes. 
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5.8.1.7 Output Selection 


When an output enters the WAIT state it is put last in the output queue of its 
priority. This is also true for an output in the HOLD state. 


Whenever an output device is free and its associated WRITER job is IDLE, the 
Output Writer determines which output, if any, will be processed. The output 
selected is the first (highest priority) to satisfy the following conditions: 


e Not be in the HOLD state. 
e Belong to a class started on the device. 


e Be directed to a device class that correlates the desired output format with a 
compatible device. 


It is possible to force an output with the FORCE OUTPUT (FO) command; this 
output is selected prior to any other, although it must still satisfy the second and 
third conditions shown above. 


Therefore, the order in which outputs are processed can be controlled by use of: 


e Output Priorities. 

e Output Classes (started or not on each device). 
e HOLD OUTPUT Command. 

e FORCE OUTPUT Command. 


5.8.1.8 Question OU02 
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If the printing of an output is interrupted by: 


e TERMINATE OUTPUT_WRITER STRONG, 
e ora HOLD OUTPUT STRONG 


e ora CANCEL REQUEST command was used in reply to a device incident, etc., 
then question OU02 is asked. 


The question OU02 is sent to the operator who submitted the SOW command. 
Therefore, if the command is submitted in the startup system or if the operator is no 
longer connected, the question cannot be asked and the reply "CUR" is assumed. 


In the reply the operator can specify where the processing of the output should 
resume from, if at all: 


nn/OU02 dvnm OUTPUT ron :ouseqnb RESTART FROM? 
(CURRENT PAGE NUMBER is current_page) 
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current_page is the page number at which the incident occurred for 
OUTPUT-WRITER. This is the page number used to compute the restart page in 
the answers FOR, BACK, CUR below. The page number is not necessarily the last 
printed page of printer buffering. 


Possible Answers: 
BEG [HOLD] [TERM] resume from the beginning of the output. 


BACK nn [HOLD] [TERM] 
resume nn pages before the current page. 


CUR [HOLD] [TERM] from the beginning of the current page (do not use this 
option after an I/O incident on a PRU 412x 
printer - see Section 6 Peripheral Operations for 
further information). 


CONT from the next line. This is used only to bypass the 
current line; 1.e. 1f that line caused the failure. 


FOR nn [HOLD] [TERM] nn pages after the current page. Jumps over nn - | 
pages without printing them. 


CAN [TERM] the output is cancelled; it will not be resumed at all. 


FROM nn[HOLD][TERM] 
start output from page number nn. 


NOTE: 
BACK nn can be abbreviated to -nn and FOR nn to +nn. 


If the length of the answer is zero, then CUR is taken as default. 


HOLD indicates that the output is to be put into the HOLD state; in this case a 
RELEASE OUTPUT is necessary before the output can be resumed. If the 
question was asked because of a HOLD_OUTPUT (HO) command, HOLD is 
implicit. 

TERM indicates that all output classes are to be terminated on this device. If the 
question was asked because of a TERMINATE OUTPUT_WRITER (TOW) 
command, then TERM is implicit. 


If the current output is held after question OU02 is replied to and TERM was not 
used, then the Output Writer tries to start a new output; if no output is suitable the 
WRITER service job goes into the IDLE state. 
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5.8.1.9 Output Writer Incidents 
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During its activity the Output Writer may encounter certain incidents which require 
operator intervention. 


1. Incident on the Output Device 


The operator is informed of the incident by message DV12, a recovery request. The 
operator recovers the device (as described in Section 6, Peripheral Operations) and 
the Output Writer resumes normal activity without further operator intervention. 
See note below. 


If the incident happened on a printer and a number of pages need reprinting the 
operator issues a CANCEL REQUEST command in response to message DV12, 
and question OU02 is asked. After switching the printer to READY the operator 
replies to OU02 indicating the number of pages to be reprinted and the output 
processing is resumed at the specified point. 


If for some reason output processing should not be immediately resumed after an 
incident, the procedure in the above paragraph should be carried out. The only 
difference is that the operator uses the HOLD option in the reply to question OU02. 


If the incident was a power-off, GCOS 7 reacts as ifa CANCEL REQUEST (CR) 
command had been issued in response to the DV12 message, and question OU02 is 
asked. 


The incident may be more serious and message OU27 is displayed and followed by 
question OU02. 


The general format of OU27 is: 


{ HELD } 
0U27 dvnm ron :ousegnb { } [WRITER TERMINATED] 
{ CANCELLED } 


RC = ccecece --> siu,return code [ON SYS.OUT FILE] 


After the operator has recovered the device output processing resumes at the point 
specified in the reply to question OU02. Normally message OU27 ends after 
HELD or CANCELLED. However, if the output has been HELD, it must be 
released before processing is resumed (In fact, the Output Writer may begin 
processing another output as soon as question OU02 is answered). 


If CANCELLED is shown, the output has been cancelled and in the case of a 
standard output it will have been erased. 


47 A2 53US 


47 A2 53US 


Running User Jobs under GCOS 7 


If WRITER TERMINATED is shown, the Output Writer must be restarted on that 
device. 


NOTE: 
If question OU02 was not asked, the Output Writer starts printing after recovery 
from the current line. This may result in that line being duplicated. In this case 
mark the line which was printed twice and inform the user. 


2. Incidents on the Volume Containing the Output File 


These incidents are treated like any other tape or disk incident (see Chapter 6, 
Peripheral Operations) and if recovery is successful the output continues without 
any further operator action. Tapes are automatically repositioned if the recovery 
was successful. 


If the incident could not be recovered, the operator issues a CANCEL REQUEST 
(CR) command. Message OU27 is displayed indicating that the output has been 
HELD, question OU02 is then asked. After the operator has replied to OU02, the 
Output Writer selects the next available output. The output must be released before 
it can be reprocessed by the Output Writer. 


3. Paper Form or Print Belt Cannot Be Used. 


If the output volume cannot be used, this may be due to an error in the WRITER or 
OUTPUT JCL parameters. In this case message OU27 is displayed indicating that 
the output is HELD. The return code displayed contains information concerning the 
erroneous parameter and therefore determines the operator response. Refer to the 
JCL Reference Manual. 


If the output volume cannot be used for any other reason, in particular after the 
issuing of aCANCEL_ REQUEST command in reply to a mount volume request, 
then message OU28 is displayed: 


0U28 dvnm [WRITER TERMINATED] 
[RC = ccecceee -> siu, return code] 


The Output Writer is terminated on the specified device and the output being 
processed is left in the WAIT state. The Output Writer can be started again on that 
device but only for outputs that do not need the unavailable volume. It is thus 
advisable to hold these other outputs before starting the Output Writer. 
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4. The SYS.OUT File Cannot be Used 


If a Permanent SYS.OUT file cannot be found, i.e. the wrong file was specified or 
the file has been deleted, then message OU26 is displayed, indicating the output 
sequence number of the incorrect file. 


0U26 dvnm ron :ouseqnb CANCELLED 


RC = ccceece -> siu, return code 
EFN = [SUBFILE = sfn] 


The output is cancelled and Output Writer selects the next output to be processed. 


In any other case where the SYS.OUT file cannot be used, i.e. the operator refused 
to mount the volume containing the file, then message OU27 is displayed showing 
that the output has been HELD and that the Output Writer has been terminated on 
the indicated device. 


5. The SYS.OUT File is Incorrect 


Sometimes unedited Permanent SYS.OUT files have errors that prevent the Output 
Writer from printing a line. In these circumstances, message OU27 is displayed and 
then question OU02 is asked. The operator should reply CONT to OU02 and print 
resume on the next line, bypassing the line at fault. For each line that is at fault the 
above messages are displayed. If there are a large number of these errors, use the 
HOLD option in reply to OU02 and consult the user. 
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5.9 Automatic Resource Management (ARM) 


This manual only gives summary information about ARM. For more details, refer 
to the ARM User's Guide, or to the System Administrator's Manual. 


5.9.1 What is ARM? 


The Automatic Resource Manager (ARM) is a GCOS 7 system administration and 
regulation tool. 


ARM as "administrator" is a set of main operator commands for communicating 
operational and optimization objectives to the system. 


ARM as "regulator" dynamically measures, reports and controls the system's 
resource consumption. 


ARM dynamically controls the distribution and usage of the three main system 
resources: 


¢ memory, 
e CPU, 
e multiprogramming levels. 


At regular time intervals, ARM measures the current workload on each of these 
resources and then, on a feedback basis, adjusts the control rules to obtain the best 
results possible within the specifications given. The general mechanism is 
summarized in Figure 5-5 ARM Mechanism. 


From ARM's point of view, the system is made up of a number of dimensions each 
competing in some degree or another for a share of the system's resources. ARM's 
overall objectives are to: 


e distribute the resources between the different dimensions according to the level 
of importance of each dimension, 


e distribute resources within a dimension according to the resources allocated to it 
and the rights and needs of the jobs running under it, 


e balance the overall distribution of resources according to the global system load. 
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5.9.2 Basic ARM and Full ARM 
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ARM has two levels of operation, called Basic ARM and Full ARM. Basic ARM is 
available with all DPS 7000 configurations. Full ARM is an option for the larger 
HPS systems. 


All features, commands and procedures described in this document apply to 
systems equipped with Full ARM. 


To find out whether your system is operating with Basic ARM or Full ARM, type 
in the DISPLAY REGULATION PARAMETER (DRP) as follows: 


S: DRP; 

This gives the following display: 

MEM = xXxxMB 

LEVEL = (BASIC or FULL) STATE = (NORMAL or DEGRADED) 


Memory size is given in Megabytes, the level of ARM that has been installed on 
the system is given and the present operational state of the ARM. FULL ARM in 
degraded state means that the BASIC ARM features are operational. BASIC ARM 
cannot be in DEGRADED state. 


Basic ARM regulates the rules concerning memory management and working set 
protection. This leads to acceptable results where there is a moderate workload, 
behaving in a moderate manner. 


Full ARM regulates not only rules concerning main memory, but also those 
concerning CPU time, and multiprogramming levels. This resolves many 
traditional performance problems which, in the past, could be corrected only 
through operator surveillance and intervention. Brief examples of the kinds of 
regulation performed by ARM are given below. 
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5.9.3 Concepts 


5.9.3.1 Execution Level (XL) 


The Execution Level (XL) is the level of importance of a given process, expressed 
as a number from 0 to 100. It is computed dynamically by ARM according to: 


e the amount of resources already consumed by the step, 


e the RELWEIGHT, XL range, and PA attributes of the dimension concerned. 


The XL computed by ARM determines directly VMM's working set decisions 
(memory allocation) and CDAC's dispatching policies (CPU allocation) for the 
process concerned. 


The XL of a dimension is the mean of the XLs of its steps. The XL of a step is the 
mean of the computed XLs of its processes. To display the current XL of a 
dimension, use the DDIM command with PERF option. 


You cannot modify directly the XL of a process but you can modify the XL range 
of its dimension, using the MDDIM command. 


5.9.3.2 Multiprogramming Limit (MPL) 


This refers to the maximum number of steps which can be in execution at the same 
time in a given dimension or a given Job Class Group (see below). 


With Basic ARM, the MPL is static and can be modified only by the operator 
commands MDDIM and MDLD. 


With Full ARM, the MPL is dynamically modified according to the current system 
load. The MPL cannot, however, go beyond the bounds set by the MPL range 
attribute for the dimension. You can modify the MPL range of a dimension using 
the operator command MDDIM. 
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5.9.3.3 Execution Level Class (XLC) 
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Certain predefined XL ranges correspond to an Execution Level Class (XLC). 
Associated with each XLC is a CPU dispatching policy, a minimum CPU 
consumption rate and a hardware priority range. 


Each XLC corresponds to: 


a hardware priority range, 

a fixed XL range, 

a CPU dispatching policy, 

a maximum CPU consumption rate. 


The following table gives the default settings of XLC characteristics. 


XL Range XLC Policy Max.Rate HPR 


100 0 F 100% O-F 
90-99 1 F 100% 8 
80-89 2 FS 100% 9 
70-79 3 FS 100% 10 
60-69 4 FS 100% 11 
50-59 5 O 30% 11-12 
40-49 6 FS 40% 12 
30-39 7 O 50% 12-13 
20-29 8 O 60% 13-14 
10-19 9 O 80% 14-15 
0-9 10 FS 100% 15 


F=Fixed non Sliced, FS=Fixed Sliced, O=Optimized. 


Note that XLC=0 is reserved for system applications and its characteristics cannot 
be modified. 
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5.9.4 Predefined Attributes 


The default attributes for the four standard dimensions are given in the following 
table. 


Table 5-15. Standard Dimension Default Attributes 


Assignment |RELWGHT| MPL XL |BWGHT)| PA |ICA/ HO 
a Range | Range 


Sys C=R-2Z | 100 | 50-50 | 0-100 | 0 | 


coll all fel al 
ea 8 steps 

[a se a 0 

BIGHT peta 190] oo toe: aoa — La 


5-58 47 A2 53US 


Running User Jobs under GCOS 7 


5.9.5 ARM Commands 


5.9.5.1 Table of FULL ARM commands 
Full ARM commands are, in alphabetic order, the following: 


Table 5-16. FULL ARM Commands 


Abbre- Command Name Command Action 
viation 


CNDIM CONNECT DIMENSION Adds new assignment criteria to a dimension. 


resource domain. 
CRDIM CREATE DIMENSION Creates a user-defined dimension, modelled on 
Deletes a user-defined dimension. No 
applications can be assigned to it. 
resource domain. 


domains. 
dimension. 
one or all dimensions. 


DISPLAY XL CLASS Displays the current values associated with an 
XL class. 


MDDIM — |MODIFY_DIMENSION Modifies the attributes of a dimension. 


MDXLC  |MODIFY_XL_CLASSS Modifies one or more characteristics of an 
Execution Level Class. 
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5.9.5.2 Availability of ARM commands 


NOTE: 
ARM commands are available only to the MAIN operator. The table below 
gives the availability of command in full and basic levels. 


The access rights of the different ARM commands are summarized in this table: 


Table 5-17. — Availability of ARM Commands 


COMMAND '"FULL' LEVEL '"BASIC' LEVEL 


MDXLC F F 
DXLC F F 
CRDIM F U 
DLDIM F U 
MDDIM F P 
CNDIM F U 
DISDIM F U 
DDIM F U 
CNFUNC F F 
DISFUNC F F 
DFUNC F P 


NOTES: 
1. F= totally available 


U= unknown command. 


P= partially available in BASIC Level. The commands and keywords in 
BASIC are: 


MDDIM dimension MPL=dec3 
DDIM dimension OPTION=MPL. 


2. The use of the CRDIM, DLDIM, CNDIM and DISDIM commands on a 
system at BASIC Level results in the following message being displayed: 
AR45 UNKNOWN COMMAND cmdnm 


where cmdnm is the name of the command used. 
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ARM Operator Messages 


We give here a list of all the ARM generated operator messages. Each is followed 
by a brief explanation of its significance. 


JOB SUSPENDED BY SYSTEM 


A job running in an overloaded dimension, whose HO attribute is on, has been 
suspended by ARM. 


JOB RELEASED BY SYSTEM 


A previously suspended job has been released for execution. 
WAIT FOR RESOURCES IN DIMENSION xxxx 

A step has been queued in the BATCH dimension" 

JOB REACTIVATED 

A step has left the BATCH dimension queue. 

RESOURCES NOT AVAILABLE NOW IN DIMENSION xxxx 


New IOF steps are rejected, and only trivial requests (at S: level) are allowed. 
WARNING: SYSTEM ENTERS THRASHING 

The system has been diagnosed as overruled. 

SYSTEM LEAVES THRASHING 


ARM has dealt with the cause of thrashing. 


ARM ENTERS DEGRADED INTO BASIC RC=cccccccc -> SIU, FC 


ARM has made an error and cannot recover from it. Only Basic ARM facilities are 
currently available. 


Please contact your support if this happens. 


GCOS 7 V9 

WARNING: SYSTEM ENTERS NORMAL USE 

This message is followed by the reason of the change of mode. 
SYSTEM BECOMES UNDERUSED 


The CPU consumption is low. 
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5.10 Domain and CDP (Customer Dedicated Processor) Overview 


These functions are available only on the DPS 7000/MTxx models. 


5.10.1 CDP (Customer Dedicated Processor) Overview 


The physical CPU resources that can be installed at the client's site can be any of 
the following processors and co-processors: 

IPU: Instruction Processor Unit Standard processor 

EPU: Extended Processor Unit (type 1) CDP1 

FPU: Extended Processor Unit (type 2) CDP2 

GPU: Extende Processor Unit (type 3) = CDP3 


Previous names for CO-processors were: 


HRP High Relational Processor (first co-processor for 
Oracle), introduced on DPS 7000/4x0/5xx/7xx series. 


X-HRP High Relational Processor (co-processor for Oracle 
and OPEN 7), introduced on DPS 7000/4x5/8xx series. 


BES Back End Server (board containing 4 EPUs in an 
DPS 7000/8xx/Mxx/Dxx) 


PSP Parallel Specialized Processor, introduced on 
DPS 7000/Cxx/Dxx/Mxx series. 
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5.10.2 Domain Overview 
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A domain represents a kind of CPU resource. There are four domains: 


standard 
CDP1 
CDP2 
CDP3 


A function is a set of applications that can be privileged, or not. A privileged 
function can be assigned to a domain. The following functions are privileged: 


SYSTEM 
ORACLE 
OPEN7 
DW7 

IQS 
OPEN7 F1 
OPEN7 F2 


A software MI must be bought to allow a privileged function to be assigned to a 
domain. 


There are four types of hardware resources and domains: see the Table below. 


Hardware Resource Domain 


IPU: standard processor for non-privileged functions STANDARD domain 
EPU: processor for all privileged functions not assigned to | CDP1 
another domain 


FPU: processor for a privileged function specified by the 
administrator 


GPU: processor for another privileged function specified CDP3 
by the administrator 


A domain exists if the corresponding hardware configuration exists. For example: 


e if your DPS 7000/MTxx has an IPU and an EPU, STANDARD and CDP1 
domains exist. 


e if your DPS 7000/MTxx has an IPU, an EPU and a GPU, STANDARD, CDP1 
and CDP3 domains exist. 
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Assignment Rules 


1. All functions can be executed using the STANDARD domain resources. This 
domain cannot be assigned to a function. 


2. The CDP2 or CDP3 domain resources can be dedicated to one privileged 
function if the administrator has connected the domain and the function. The 
connection is established using the CONNECT DOMAIN command. 


3. The CDP1 domain resources are available to all privileged functions not 
connected to the CDP2 and CDP3 domains. 


4. A function assigned to CDP1 (using CDP1 resources) can be disconnected. In 
this case it can use only the resources of the STANDARD domain. 
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6. Peripheral Operations 


6.1 Introduction 
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This section describes the functioning of the system peripheral devices under 
GCOS 7 V7, V9 and V10. 


The following topics are discussed: 


Device Handling Overview: 
introduces the terminology, characteristics, commands and messages common to 
all devices. 


Disk, Magnetic Tape and Tape Cartridge Operations: 
describes the operational characteristics of each device class. 


Printer Operations 


Hardware Incidents: 
describes incidents, recovery, and error logging. 


Monitoring Device Incidents: 
describes use of Device Trace commands to monitor device incidents. 


GCOS 7 System Operator's Guide 


6.2 Device Handling Overview 


Operators must understand the following terminology: 


DEVICE TYPE (dvtyp) 


Examples: 


TAPE 


DEVICE NUMBER 


DEVICE IDENTIFIER 
(dvnm) 


{ VOLUME 


{ 
{ FILE 
REMOVABLE VOLUME 


NON-REMOVABLE 
VOLUME 


Each device belongs to a device type identified by two 
letters. 


MS (Mass Storage disk) 

CT (magnetic tape CarTridge) 
MT (Magnetic Tape reel) 

PR (PRinter) 


See Appendix F Device Types and Classes for more 
information. 


Magnetic tape cartridge (cartridge tape) or magnetic 
tape reel (reel tape). Cartridge tapes can be in a 
Cartridge Tape Library. 


Each device of a device type is identified by a device 
number (two digits or letters). 


The device identifier is made up of 2 letters for the 
device type and of 2 characters for the device 
number (for instance PROI, MSA3). 


Disks and tapes are referred to as volumes. A volume 
contains one or more files. Each file is, for the user, 
a set of information. 


Tapes. 


Non-removable disks. All disks supported by 
GCOS 7 are non-removable. 


VOLUME DESCRIPTION Volumes are identified by their volume name and 


their device class. 


VOLUME NAME (volnm) 6 characters which can be alphabetic, alphanumeric 


DEVICE CLASS (dve) 


or numeric. 


Symbolic name used to describe the characteristics of a 
device. Its first two letters are the device type. 
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Examples: MS/FSA (FSA disk) 
MS/B10 (B10 disk) 
¥Y (not supported on DPS 7000/XTA) 
CT/M6 
MT/D6250 (6250 BPI density reel tape) 
¥ Seen as CT/M6 on DPS 7000/XTA 
See Appendix F Device Types and Classes for more 
information. 


PREMOUNTING For a removable volume: the action of loading a 
volume on a device before it is actually needed or 
requested. 


For a non-removable volume: the action of switching 
the device to the READY state before it is actually 
needed or requested. 


MOUNTING For a removable volume: the action of loading a 
volume on a device when it is requested by a job. 


For a non-removable volume: the action of switching 
the device to the READY state when it is requested by 
a job. 


If a mount request from a job cannot be satisfied, the 
operator indicates this to the system by using the 
CANCEL REQUEST (CR) command. 


AVR Whenever a device is put into the READY state, the 
system tries to identify the volume. This operation is 
called Automatic Volume Recognition. 


AVR identifies native volumes (volumes labelled 
according to the GCOS 7 standard). The facility is also 
available for print belts which are identified by a 
hardware "label" on each belt. For these volumes, no 
other operator action is required. (Non-standard 
volumes have to be presented to the system by an 
operator using the NAME VOLUME command). 
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MDHW command All incidents are recorded in the SYS.ERLOG 

DEVICE INCIDENT system file. The system provides functions for 
handling this file. When necessary, the 
MODIFY HARDWARE CONFIGURATION 
(MDHW) command with the (OUT) parameter can 
be used to remove a faulty device from the 
configuration. The MDHW command with the (IN) 
parameter enables the operator to reinsert the device 
into the configuration. 


6.2.1 Device States 


A device (known within the system) is always in one of the following device states. 
To find the state of a device, use the 

DISPLAY HARDWARE _ CONFIGURATION or DISPLAY CONFIGURATION 
command. States which are displayed by DHW or DC are denoted below in upper 
case. 


e OUT (or HELD) 
The device has been removed from the system configuration by use of the 
MDHW (OUT) command. This can be performed when the device is free. It can 
be put back into the configuration by use of the MDHW (IN) command. (These 
two commands are described in Chapter 8 Description of the Operator 
Commands). 


e free 
The device is not being used. It may be in the hardware state "off-line" (seen as 
STANDBY), STANDBY or READY. If it is READY, a volume may be 
premounted (DHW or DC then displays PREMOUNTED). When a native 
volume is premounted the device may become allocated without any operator 
action. 


e ALLOCATED 
The device is being used by one or several users. Its normal hardware state is 
READY. If an incident has occurred, a RECOVER request may be pending 
(DHW or DC then displays RECOVER). A MOUNT request may also be 
pending for this device (DHW or DC then displays MOUNT). The 
CANCEL REQUEST command can be used to cancel this request, but in this 
case, if the device is allocated to several jobs, they are aborted. 
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On a system configured for Mirror Disks usage, the MIRROR attribute and specific 
MIRROR states are displayed by DHW or DC for mirrored disks. Refer to the 
Mirror Disks User's Guide, this option is no more available on DPS 7000/XTA 
platforms. 


NOTE: 
RESIDENT disks are invariably allocated to X1 and to X1 only. It is therefore 
not possible to see who are the users of files on such disks. 


6.2.2 Device Allocation in Device Mode 


When a job needs the use of a device out of usual GCOS 7 rules, it can request (in 
its JCL) that the device be allocated in device mode. 


From that instant the handling of the device is entirely under the responsibility of 
the user (which can request mounting or dismounting of volumes through specific 
user messages). 


Incident handling and device availability are still the system responsibility. 


This allocation mode is, typically, used by the Test and Diagnostic modules. 


6.2.3 Unknown Device 


When a device unknown to the system (due to a lack of conformity between the 
System Resource and Status Table (SRST) and the GCOS 7 Software Device 
Tables or to a hardware incident) is made READY or set to STANDBY, the 
following message is displayed: 


AV54 UNAVAILABLE PATH (PC = penb, LC = Ilcnb) 


Action to be taken depends on the conditions which caused the message to be 
displayed: 


e re-initialize with the correct SRST; 

e orrun the CONFIG utility to have the actual hardware configuration taken into 
account at the next ISL; 

e or try to insert the device into the GCOS 7 configuration by the MDHW IN 
command. See the Console Messages Directory for more details. 
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6.3 


6.3.1 


6.3.1.1 
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Disk and Tape Operations 


This subsection is divided into 3 parts: 


e Volume Characteristics: 
describes the logical characteristics of the various types of volumes. 


e Premounting, mounting and dismounting: 
describes the system responses to physical operations. 


e Incidents: 
discusses various non-fatal incidents which can occur when the system is 
reading or writing to disk or tape. 


Volume Characteristics 


Disks 


The following is a description of the logical characteristics of the different 
categories of volumes supported by the system. 


Characteristics which are displayed by the DHW or DC operator command are 
denoted below in upper case. 


When the system first tries to access a disk, it looks for the disk volume label 
(which contains the volume name). If the volume label is present and in the correct 
format, the disk is identified as native; otherwise it is considered as non-standard 
(NSTD). 


The system can recognize several categories of native disks: 


1. SYSTEM disk 


The SYSTEM disk is recognized as such because it is the disk from which 
Storage Load is performed; it supports the SYS.BKSTO file. It cannot be 
removed from the configuration by the 

MODIFY HARDWARE CONFIGURATION (MDHW) command. 


2. RSDT disks (resident disk) 


The operator may define a disk as resident during System Loading. RSDT 
disks are disks which, like the SYSTEM disk and the backing store disks, are 
required in the configuration. (See question ILO1 in Chapter 3 Starting and 
Terminating a GCOS 7 Session). 
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NOTES: 


1. There is no necessity to define any RSDT volume, provided that all the 
system files are held on the SYSTEM disk and provided that there is 
enough space for the temporary files. 


2. RESIDENT disks are invariably allocated to X1 and to X1 only. It is 
therefore not possible to see who are the users of files on such disks. 


3. BKST disks (backing store disks) 


These disks support backing store files. They are declared as BKST, LIB, 
PVMEF or TVMF during system loading. (See question ILO1 in Chapter 3 
Starting and Terminating a GCOS 7 Session). 


4. SRV disk (service disk) 


The service disk contains SPOS service files (SYS.FW.*) used at system 
initialization time on DPS7000/An systems. It is handled by GCOS 7 like 
BKST disks. 


NoTE: 
The SYSTEM, RSDT, BKST and SRV disks cannot be mirrored disks (refer to 
Section 3). They are allocated to X1 (system) and must not be put in WRITE 
PROTECT, STANDBY or be powered off. They must keep available to the 
system throughout the GCOS 7 session. 


5. SHARED disks 


These disks are shared between coupled systems. They are declared during 
System Loading or dynamically with the MDHW command. SHARED disks 
are allocated to X1, 


6. Other disks 
User disks. They contain user files. 


In addition to the above characteristics, the DHW or DC command shows: 


e NVTOC for volumes having the FBO volume format which are not high 
reliability disks 

e HRD, followed by the reliability characteristic for high reliability disks. For 
RAID-1 disks, RD1 is displayed, for RAID-S disks, RDS is displayed. 


On a system configured for Mirror Disks usage, the MIRROR attribute and specific 
MIRROR states are displayed by DHW or DC for mirrored disks. Refer to the 
Mirror Disks User's Guide, this option is no more available on DPS 7000/XTA 
platforms. 
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6.3.1.2 Tapes 


6-8 


When the system finds that a tape contains standard tape labels (which contain the 
volume name) in the correct format, it treats the tape as native; otherwise it is 
considered as non-standard (NSTD). 


Native reel tapes can use either EBCDIC or ASCII recording code. A native 
cartridge tape is a cartridge tape with a standard volume label in EBCDIC 
recording code. Cartridge tapes with a label in ASCII recording code are processed 
as non-standard tapes. Tapes may have various physical characteristics (density, 
etc.) which can vary a great deal from one tape to another. It is therefore essential 
that it be premounted/mounted on a drive which has the corresponding physical 
characteristics. If not, or if nothing at all can be read on the tape, it is treated as a 
non-standard volume (but messages displayed on the operator console show 
UNKNOWN VOLUME). 


Native tapes belong to one of two types: 


1. WORK tapes 


These are created by the VOLPREP utility. They are recognized as WORK 
tapes by their tape labels. They may also be prepared with the 

PREPARE TAPE (PRPTP) GCL command. (See the JOF Terminal User 
Reference Manual.) 


Any job may ask for a WORK tape. A suitable tape is then mounted by the 
operator and is normally assigned only for the duration of that job. After this it 
reverts to a pool of WORK tapes which is controlled by the Operations 
Manager. 


Ifa WORK tape is used for dynamic permanent file extension it loses its 
WORK quality. The operator is informed by the following message: 


FPO1 dvnm ron.ssn TAG volnm FOR EFN efn 
The operator should then note that the tape belongs to the indicated file and 
inform the user accordingly. 


A work tape must be in WRITE PERMIT, otherwise the following message is 
displayed: 


(DV11) hh.mm dvnm MOUNT "WORK" VOLWR FOR ron 
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User tapes 


These are created by user jobs and are used to store permanent files. These 
tapes belong to the user who created them either until the expiration date 
(specified in the tape labels) has been reached, or until they are released by a 
user action. 


NOTE: 


Any user tape whose expiration date has been reached can be overwritten by a 


job which specifies the correct volume name. 


6.3.2 Premounting, Mounting and Dismounting 


6.3.2.1 Premounting 


The operator is able to save computer time by anticipating job requests, by 
premounting the volume before the job has asked for it. 


For removable volumes, the volume is loaded on any available device (with the 
required characteristics) and the device is set to READY; for non-removable 
volumes, the device is set to READY. The system now tries to recognize the 
volume and it may or may not succeed: 


1. Ifthe volume has been recognized, the following message is displayed: 
(DV21) hh.mm dvnm PREMOUNTED volnm [NVTOC | ...] 

2. Ifthe volume has not been recognized, the system replies with one of the 
following: 
(DV21) hh.mm dvnm PREMOUNTED [volnm] NSTD [FBO] [36T] 
DV24 dvnm UNKNOWN VOLUME 
The name of the volume must be given by the NAME VOLUME command. 
After that the following message is displayed: 
(DV21) hh.mm dvnm PREMOUNTED volnm NSTD [36T] 

NoTE: 
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The NAME VOLUME command is mandatory, even if a volume name 
appeared in the displayed message. The volume name given in the 
NAME VOLUME command can be a new one or the same one. 
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6.3.2.2 Normal Mounting 


The following does not apply to non-removable volumes, Cartridge Tape Libraries 
and Any Media mode for tapes. 


A job is aborted if it asks for more devices, either IN (inserted in the configuration) 
or OUT (removed), than there are in the system. It can be queued if the devices 
exist, but are not available by now (allocated or OUT). 


When there is an available device, if a job requires a volume and the operator has 
not premounted it, the following message is displayed: 


hh.mm dvnm MOUNT [volnm] ["WORK"] [NSTD] ... FOR ron 
(WORK indicates that a native WORK tape is required). 
The following information can also appear: 


density, 

S (streamer reel tape), 

C (cartridge tape with compaction), 

IMP (when mounting on that device is imperative), 
VOLWR (WRITE PERMIT), 

PROTECT (WRITE PROTECT). 


The operator should then take the following actions: 


1. Ifnecessary, dismount a volume currently loaded on any device. 


2. Mount the requested volume on any device of the same type and with 
compatible characteristics. 


3. Switch the device to READY. 
4. For non-standard volumes, issue a NAME VOLUME command. 


If the mounting request cannot be satisfied, the operator has to answer the 
mounting request with a CANCEL REQUEST command. This causes the job to be 
aborted, unless the corresponding file was an ‘optional file. 


NoTE: 
It can occur that a DC command is followed by the message: "dvnm MOUNT 
volnm ... FOR ronlist" while there has been no request to mount a volume. This 
occurs when DEFER has been used in the ASSIGN command, or in the case of 
a dynamic ASSIGN, or for a WORK tape. 
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6.3.2.3. Mounting of Non-removable Volumes 


Usually, all non-removable volumes are premounted. It can nevertheless happen 
that some devices are on STANDBY, or have been removed from the 
configuration. 


For STANDBY devices, the processing is similar to the one described for 
removable volumes (if the device has been previously READY, which allows the 
system to know the volume name): a MOUNT message is displayed, which can be 
answered by switching the device to READY, or bya CANCEL REQUEST 
command. 


There are specific operating rules for mirrored disks concerning MOUNT requests 
and CANCEL REQUEST commands. Please refer to the Mirror Disks User's 
Guide. 


For OUT devices (or devices which have never been READY), the job can be 
queued. If there are no such devices, it is aborted, because that means that a wrong 
volume name has been given. The system knows the volume names of all the 
volumes which can be present in the configuration. 


6.3.2.4 Mounting Cartridge Tape Library Volumes 


Sites using the CLC (Cartridge Library Client) component 
This component is not available on DPS 7000/XTA platforms. 


If the CLC component is operational, mounting is performed automatically by the 
system. (For non-standard cartridge tapes, the system automatically performs the 
equivalent of a NAME VOLUME). If the mount request cannot be satisfied 
because the volume is not present in the Cartridge Tape Library, or because the 
volume cannot be overwritten, the system automatically cancels the mount request, 
which causes the step to be aborted. 


If the CLC (Cartridge Library Client) component is not operational, display the 
CLC state with the DISPLAY CLC (DCLC) command and then, depending on the 
information displayed, either: 


e start the CLC component with the START _CLC (SCLC) command, if it has not 
already been started, 


e or establishes communications with the Cartridge Library Server (CLS), if the 
CLC has already been started. 
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Sites using the CLX (Cartridge Library Unix) component 


If the CLX component is operational, mounting is performed automatically by the 
system. (For non-standard cartridge tapes, the system automatically performs the 
equivalent of a NAME VOLUME). If the mount request cannot be satisfied 
because the volume is not present in the Cartridge Tape Library, or because the 
volume cannot be overwritten, the system either cancels the request or waits for 
operator intervention. This action depends on the declaration made in the 
configuration file CLX_CONFIG. 


If the CLX (Cartridge Library Unix) component is not operational, display the 
CLX state using the command DCLX. If necessary, start CLX with the SCLX 
command. Starting CLX requires OPEN 7 to be operational. 


For more information about the CLX system, see the CTL-UNIX Server User's 
Guide. 


6.3.2.5 Mounting of Tapes in Any Media Mode (media = *) 
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NOTE: 
This mode is not allowed for cartridge tapes in a Cartridge Tape Library. 


Normally user programs specify the names of the volumes to be used and the 
operator receives the requests specifying the volnm of the volume to be mounted. 
In some cases the user program is ignorant of the number of volumes, or of the 
volnms which are to be used. The user may then use the "MEDIA=*" parameter in 
the ASSIGN JCL statement specifying that the responsibility and the order of 
mounting are left entirely to the operator. Each volume within a set of volumes 
must have the same device attributes. 


The volumes to be used (possibly restricted to 1) are delivered to the operator as a 
set of ordered volumes, each of which has an external identification, that reflects 
the order in which they are to be mounted by the operator. 


The system asks the operator to mount the first volume of the set IMP shows that 
the mounting on that device is imperative): 


*hh.mm dvnm MOUNT *1 ... IMP ... FOR ron. 
The operator should then take the following actions: 


1. Ifnecessary, dismount the volume currently loaded on the required device 
2. Mount the first volume of the required set on the required device 


3. Switch the device to READY. 
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After processing the first volume of the set, the system asks the operator to mount 
the second volume in the same way: 


*hh.mm dvnm MOUNT *2 ... IMP ... FOR ron. 


The operator then proceeds as previously stated until the last volume of the set has 
been processed. ACANCEL_ REQUEST command specifies that the requested 
volume is not to be mounted and the running job step is to end normally. 


Whenever possible the system checks that the mounting sequence is correct 
(multivolume file) or that the user-specified file is found on the volume. When the 
system detects a problem, the operator is asked to confirm the mounting action: 


nn/FP04 dvnm vol-occur-nb. VOLUME SEQUENCE CORRECT? 
The possible answers are: 


YES The operator confirms that the nth volume of the set 
has been mounted, and that the volume mounting 
sequence is correct. Depending on the case, the user 
program is notified or the operator is asked to mount 
the next volume. 


NO The operator made a mounting error; therefore a mount 
request for the correct volume is re-issued by the 
system. 


6.3.2.6 Dismounting 


A volume can be dismounted (or removed from the configuration) when the device 
is not allocated. The dismounting operation is not acknowledged by the system. 
The DISPLAY HARDWARE CONFIGURATION command may be used to 
ascertain whether a particular device is deallocated. 


A.user may specify in the JCL that a tape is to be dismounted after its use, in which 
case the tape is fully rewound. 
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6.3.3 Incidents 


Incidents involving disk or tape devices can be of the following nature: 


e An input/output operation attempt is unsuccessful, but the affected device 
remains in the READY state. 


e Transition of the device to STANDBY (or power off). This may result either 
from a physical action (the operator pressing the appropriate button and/or 
dismounting the volume) or from a hardware/firmware problem. 


e WRITE PROTECT violation on disk or tape. This leads to a system request for 
operator action which might involve the START_DEVICE command or the 
CANCEL REQUEST command. 


6.3.3.1. Input/output Operation Incidents 


Several retries (the actual number is dependent upon the type of operation) are 
attempted by hardware and software to complete an unsuccessful I/O operation in 
which the affected device has remained READY. 


If a retry is successful: 


e There is no notification, although the original incident is reported if the 
START DEVICE TRACE command (described later in this section) was 
entered. 


e The event is recorded by Error Logging in SYS.ERLOG file. 


e There is no effect on the step to which the I/O operation applies (the retries are 
invisible to the step). 


If all retries fail, this is an irrecoverable I/O error. The step attempting the operation 
is notified of the irrecoverable condition and is then usually aborted. 


NoTE: 
An irrecoverable I/O error involving a system file can cause a system crash. 
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6.3.3.2 Transition to STANDBY (or power off) 
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NOTE: 


a STANDBY push button does not exist on all devices. 


A disk or tape device which is allocated to a user or to the system may be switched 
to the STANDBY (or power off) state either by an operator action or as the result 
of hardware failure. Three cases may occur: 


1. 


The drive contains a SYSTEM or BKST disk. The following message is 
displayed: 


AVO04 dvnm SWITCH volnm TO READY 

The operator must switch the device to READY. If this is successful, no 
further action is requested and no message is displayed. 

If this is unsuccessful AVOS is displayed: 

AVO5 dvnm MOUNT volnm IMPERATIVE 


There is clearly a hardware problem with the device. Hardware initialization 
must now be performed (see also Hardware Failure). 


NOTE: 


2. 


As long as the SYSTEM disk is in STANDBY, system activity is limited by its 
inability to access system files. 


The device is in a Cartridge Tape Library. 
The following message is displayed: 


DW12 dvnm RECOVER volnm FOR ron 


The system then automatically performs a CANCEL REQUEST, and the step 
which is using the volume is aborted. 


Otherwise, the following message is displayed: 
DV12 dvnm RECOVER volnm FOR ron 

The operator has a choice at this point and may: 
a. Try to recover 


For removable volumes, remount the volume, either on the same device or on 
any other device of the same type and characteristics. For non-removable 
volumes, switch the device back to READY. 


If recovery is possible, the I/O operation is retried. Tapes are repositioned 
before a retry except during open or close operations or if they are used for a 
VOLSAVE, VOLREST or FILREST utility. 
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NOTE: 


If the mounting request for that volume was IMP (imperative), it must be 
mounted again on the same device. 


b. Give up recovery 


Use the CANCEL REQUEST command to indicate this to the system. All the 
steps which have allocated the volume are usually aborted, since they all try to 
access the unavailable volume. 


It is also possible to use the CANCEL JOB (CJ) command to kill the job for 
which the volume is allocated. Be careful; using CJ leaves the device in 
STANDBY if the cancelled job was the only one which had allocated the 
volume. If there are others jobs present, the device remains in the RECOVER 
state. 


There are specific operating rules for mirrored disks concerning RECOVER 
requests, CANCEL REQUEST and CANCEL JOB commands. Please refer 
to the Mirror Disks User's Guide. 


6.3.3.3 Write Protect on tapes 
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If a reel tape is mounted without its permit ring, it is said to be in WRITE 
PROTECT and no writing can be done on the tape. If the permit ring is present, the 
tape is in WRITE PERMIT. 


For a cartridge tape, the protection depends on the position of the file-protect 
selector on the side of the cartridge. A cartridge tape from a Cartridge Tape Library 
is in WRITE PROTECT when a white dot appears in a dark background above the 
thumbwheel. 


1. 


If PROTECT has been indicated for the tape, it is mandatory to mount the 
tape in the WRITE PROTECT state. If this is not done, the following message 
is displayed: 

* DVO6 dvnm SWITCH volnm FOR ron TO PROTECT 


If a job attempts to write on a tape in WRITE PROTECT the following 
message is displayed: 


DVO7 dvnm SWITCH volnm FOR ron TO PERMIT [AND REPLY (SDV, 
CR ee 2] 


The operator action depends on whether or not it is normal (that is requested 
by the user or not) for this tape to be in WRITE PROTECT: 


a. Abnormal WRITE PROTECT (not requested by the user). 
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The operator: 


— dismounts the tape, 
— remounts it in the WRITE PERMIT state, 


— if requested, indicates this to the system using the START DEVICE 
command.. 


No further action is required and no message is displayed. 


b. Normal WRITE PROTECT (as requested by the user, the mounting request 
indicates PROTECT). 


The operator indicates to the system that the tape will not be set to WRITE 
PERMIT, by the CANCEL REQUEST command. In this case, the step which 
attempted to access the tape is aborted. 


NOTE: 
For a cartridge tape in a Cartridge Tape Library, the following message is 
displayed: 


DWO7 dvnm SWITCH volnm FOR ron TO PERMIT 


But the system then automatically performs a CANCEL REQUEST 
command and the step which attempted to access the tape is aborted. 
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6.4 
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Printer Operations 


The printer operations described in this section are general and depend little on the 
type of the printers. 


There are: 


e belt printers, which use a print belt as their print medium. 
Print belts can be changed so that a different character set can be used. The PR54 
(PRU4112, PRU4113) and PR88 (PRU4120, PRU4121) are belt printers. 
These printers are no more supported since end of 2000. 


e dot matrix printers, which use dot matrix technology. 
Characters (and graphics) are formed by assembling groups of dots in matrices 
(hence the term "dot matrix"). 


— PR90, (not supported on DPS 7000/XTA platfprms) 
— PR800, 900, 
— PR 701, 801, 901, 
— PR702, 802, 902, 
— PR702A, 802SA, 902SA 
Printer configuration parameters are controlled via the SYS.URCINIT system file: 


e character set to use (this corresponds to a belt for belt printers), 
e form control information, 


e the physical vertical format unit (VFU) used by some printers (see also Section 
6.4.1, Paper Form Operations). 


For more information on the SYS.URCINIT file, see Appendix D The 
SYS.URCINIT Printer Control File. 


For more information on the Dot matrix printers, refer to the Printer User's Guide. 
The alignment of a paper form can be visually checked using the Print test routine. 
These aspects of printer operations are described below under the headings: 


e Paper Form Operations. 
e Print Belt Operations. 
e Print Incidents. 


NOTE: 
During System Loading the printer is handled in a manner different from that 
described below. 
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6.4.1 Paper Form Operations 


An installation may define its own in-house paper form standards. Each type of 
paper form has its own characteristics: page length, perforations, preprinting, etc. 
Each of these form types is entered into a system file (called SYS.URCINIT) and is 
allocated a 4-character name by which it is known both to the users and to the 
system. 


Thus a user job can call for a particular paper form to be used for its output. If this 
paper form is not mounted at the time of output - the system remembers which 
form is mounted - the system asks the operator to mount the correct form. 


Once the correct form is mounted, output begins. The handling of page lengths and 
paper movement is performed automatically by the system which holds all the 
necessary details in its SYS.URCINIT file. 


6.4.1.1 Paper Premounting 
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To premount a paper form, perform the following actions: 


1. Switch the printer to STANDBY (if it is not already in STANDBY). 
2. Mount the paper. 


3. Preferably leave the printer in STANDBY (see Note below). If the printer is 
already allocated, switching it to STANDBY causes an incident, and the 
message 


DV12 dvnm RECOVER volnm FOR ron 


is displayed. This request is periodically repeated until it is either satisfied or 
cancelled. 


At loading, the system treats the printer (if it is switched to READY) as if the 
standard paper were mounted, and the message: 


hh.mm dvnm PREMOUNTED 0000 


is displayed. 


NoTE: 
If, after changing the paper, the printer is switched to READY, the system 
continues as if no paper change had occurred. Therefore, it may well be 
advantageous to leave the printer switched to STANDBY so that a mounting 
request will be displayed if the wrong paper is mounted. 
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6.4.1.2 Paper Mounting 


Normal Case 


When a paper form is required by a job or the Output Writer (see Note below) and 
is not already mounted, the system displays the message: 


hh.mm dvnm MOUNT volnm FOR ron 


and switches the printer to STANDBY with the PRINT CHECK indicator on. The 
operator should perform the following actions: 


1. Mount the paper. 
2. Then press the START button to switch the printer to READY. 


Abnormal Case 
The following abnormal case may occur during paper mounting: 


The request cannot be satisfied (for example, the paper form is not available). The 
CANCEL REQUEST command should be used. If the paper form was requested 
by the Output Writer, the WRITER service job is terminated and the output being 
processed is left in the WAIT state. If it was requested by a user, the user step is 
aborted. 


NOTE: 
If the user requests a print belt together with a paper form, mounting messages 
are issued for both; thus the required belt can then be mounted at the same time 
as the paper. 
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Print Test Routine 


The Print Test routine allows the operator to verify that the paper is correctly 
aligned. It is started using the TEST_DEVICE (TSTDV) command (see Chapter 8 
Description of the Operator Commands). 


NOTE: 
On some printers, there is a PRINT TEST pushbutton to start the Print Test 
routine. 


The standard Print Test (a user can specify another Print Test, but it must be stored 
in the SYS.URCINIT file) is the printing of a full line under the paper fold. The 
line is: 


SYS.URCINIT CREATION DATE mm/dd/yy 


During the mounting of a paper form the system sets the printer to STANDBY with 
the PRINT CHECK indicator on. Once the paper is mounted, the operator starts the 
Print Test routine (TSTDV command or PRINT TEST pushbutton), with the 
following effect: 

e The system sets the printer to READY. 

e The Print Test routine is executed. 


e The system resets the printer to STANDBY with PRINT CHECK on and 
displays the message: 


DV45 dvnm SWITCH TO READY 


The operator can then visually check that the mounting is correct: 


e Ifthe paper form alignment is not correct, it can be corrected and Print Test can 
be used again. 


e Ifit is correct, switch the printer to READY. 


The Print Test routine can be performed at any time by switching the printer to 
STANDBY (if necessary) and using the TSTDV command or pressing the PRINT 
TEST button. The result is the same as that described above. 
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6.4.2 Printer Incidents 


Line Printer Incidents 


Most printer incidents (end of paper, etc.) result in the printer being set to 
STANDBY. Some more serious incidents result in the printer being switched to 
POWER OFF. 


When an incident occurs, and the printer is being used, the following message is 
displayed: 


DV12 dvnm RECOVER volnm FOR ron 


The operator may either: 


Try to recover 


Correct any obvious cause (end of paper, paper jam, printer open), then make the 
printer READY. Printing resumes with the line at which the incident was 
detected, which may result in a line or two being duplicated. If the incident 
involves a disengaged tractor, press the SKIP button prior to making the printer 
READY, to avoid a line overlapping the previously printed line. 


Give up the recovery 


Inform the system of this choice through the CANCEL REQUEST command. If 
the printer is being used by a step, that step is aborted. This is also used to ask 
the Output Writer for a page recovery (see Section 5.8.1.9 Output Writer 
Incidents). For POWER OFF conditions the job reacts as if a 

CANCEL REQUEST command had been issued. 


In certain cases (normally after a POWER OFF incident) the system may indicate 
that it is unable to recognize the printer by giving the message: 


DV17 dvnm MEDIA RECOGNITION IMPOSSIBLE 
RC = XXXXxxxx, siu module_id,return-code 


If this happens, press the STOP and then the START pushbuttons on the printer. 


NOTE: 
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During the printing of the PRLOG utility report on a non-standard paper form 
(i.e., one whose length is not 11 inches), the printer may enter the STANDBY 
state with the NOT SYNCHRONIZED indicator lit. Such an incident can be 
avoided by redefining the printing parameters of the PRLOG utility REPORT 
file. For more details, refer to the Note at the end of Section 6.5.3 Error 


Logging. 
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6.5 Hardware Incidents 


Hardware incidents, and the way in which the system reacts to them, are discussed 
below at three levels: 


e Device Incidents. 
e Peripheral Processor Incidents. 


e Error Logging. 


6.5.1 Device Incidents 


The system provides a set of functions which help in maintaining devices in a good 
operational state. When incidents do occur, these functions allow the system to 
handle them with as little damage to user programs as possible. 


The handling of incidents on each particular type of device has been described in 
the corresponding incident paragraph above. 


More serious incidents might cause the peripheral processor to enter the "STOP" 
state - specific operator action is then required. 


All incidents on devices, or peripheral processors are recorded by the Error 
Logging mechanism, for further use by the Service Center. Specific commands are 
provided for Error logging control (see Section 6.5.3 Error Logging). 


The MODIFY HARDWARE CONFIGURATION command (MDHW) is 
provided to take a device out of the configuration (for handling by the Service 
Center, or to prevent its use by the system) and then to put it back in the 
configuration. 


The Display Device Trace mechanism provides an operator with a record of device 
marginal conditions. 


On-Line Test and Diagnostics programs are provided to help detect and diagnose 
problems. For further information see the Operator Reference Manual. 
No OLTD programs are available on DPS 7000/XTA platforms. 


The operator is encouraged to use these programs before informing the Service 
Center of device incidents. 
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6.5.2 Peripheral Processor Incidents 


If an incident occurs on one of the peripheral processors, the system switches the 
processor to STOP and reacts as follows: 


Failure of the Mass Storage Processor or the IOP/PXU. When the SYSTEM disk 
has a single access path through the MSP, the MSP or IOP/PXU controls the 
drive the system disk is mounted on. 


Because the system disk can no longer be accessed, no more useful work can be 
performed and the following message is displayed: 


* AVO1 GCOS : CRASH. NO DUMP followed by: 
* AVO1 CHANNEL EXCEPTION ON MCnn PCpp 


Magnetic Tape or Mass Storage Processor failure. The following message is 
displayed: 


* hh.mm dvnm PSI pcnb FAILED 
It is still possible for the system to run, but the devices controlled by the failed 


processor cannot be used; if these devices have a single access path, they are 
automatically removed from the configuration. 


NOTE: 


If only the console keyboard has failed, there is no indication on the SOP. 


In any of the above cases the operator should: 


1. 
2. 
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Note any abnormal indications on the SOP and other Maintenance Panels. 


Take any necessary action as described in the appropriate Operator Reference 
Manual. 


Try to recover the system. Perform a complete initialization, if necessary. 


Run the available operator tests and diagnostics. Contact the Service Center. 
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6.5.3 Error Logging 


47 A2 53US 


Every event which could be of help to the Service Center is recorded in a system 
file called SYS.ERLOG. 


Examples of such events are the successful retry of an I/O operation or a marginal 
condition detected by a peripheral. 


It is essential to maintain enough free space in the SYS.ERLOG file, if not, 
information may be overwritten and lost. 


When half the file is full, the following message appears 


ELO1 SYS.ERLOG FILE 50% FULL 


The PRLOG utility is now used to print the information stored in the SYS.ERLOG 
file and to free the corresponding space. 


If the PRLOG utility is specified in the Config. job (see the GCOS 7 System 
Installation Configuration and Updating Guide), you can specify a percentage 
other than 50% and/or specify a command to be executed automatically; for 
example, EJR PRLOG LIB=SYS.HSLLIB VALUES = (‘PRLOG-options’). In this 
case, the system automatically prints the contents of the SYS.ERLOG file. 


If the PRLOG utility is not specified in the Config job, the following message 
appears 


ELO3 RUN PRLOG 


The operator must now run the PRLOG utility and save its output for later analysis 
by the FER. 


If the PRLOG utility is not run before the SYS.ERLOG file is full, the message: 
ELO1 SYS.ERLOG FILE FULL 


is displayed, and if PRLOG is still not run before SYS.ERLOG has been 
completely overwritten then the message: 


ELO1 SYS.ERLOG FILE FULL DATA LOST UP TO date 


is displayed, indicating all the information in the SYS.ERLOG file up to the 
indicated date has been lost. 


Certain abnormal situations cause the following messages to be displayed: 
ELO1 SYS.ERLOG FILE UNAVAILABLE 


This message, indicating an error (probably on the SYS.ERLOG file), causes Error 
Logging to work in "Reduced Mode". In this state PRLOG cannot be run and error 
messages are displayed automatically on the console. 
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It can also indicate that due to an error the whole set of Error Logging functions are 
unavailable. This is called "Trace Only Mode" because all events that would have 
been stored on the SYS.ERLOG file are displayed on the console instead. 


ELO1 SYS.ERLOG FILE REINTIALIZED 


This message is issued at GCOS 7 initialization when the SYS.ERLOG file is not 
initialized or when the disk supporting the SYS.ERLOG file does not match the 
system disk under which the file has been initialized (this may happen after volume 
duplication). This means that the previously stored events are erased as they do not 
relate to the current system. 


The operator can write comments on the SYS.ERLOG file using the 
SEND_ERROR_ LOG (SNDERLOG) command. The DISPLAY ERROR LOG 
(DERLOG), MODIFY_ERROR_ LOG (MDERLOG), 

TERMINATE ERROR LOG (TERLOG) and START ERROR LOG (SERLOG) 
commands are used by the Service Center. See Chapters 7 and 8 Description of the 
Operator Commands. 


NOTE: 
During the printing of the PRLOG utility report on a paper form whose length is 
not 11 inches, the printer may enter the STANDBY state with the NOT 
SYNCHRONIZED indicator lit. Such an incident can be avoided by redefining 
the printing parameters of the PRLOG utility REPORT file. 


For example, when using a paper form 12 inches long, the JCL values of the 
standard PRLOG Job in the SYS.HSLLIB should be modified as follows: 


VALUES='PROLOG OPTIONS!, FORMHT=96, FF1=94, HOF=8, PRDEN=8; 
STEP H_ PRLOG ...... ‘ 
STEP H_ PRLOG ...... i 
DEFINE REPORT PRINTER=(FORMHT=96 FF1=94 HOF=8) ; 
ENDSTEP ; 


For other paper form heights, contact the Service Center. 
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6.6 Monitoring Device Incidents (Device Trace) 
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For each device in the configuration, a threshold value is declared at system 
generation which defines the acceptable number of logged events on a given 
device. When that threshold is reached, the message: 


AV16 dvnm log-ev-pct % EVENTS (ev-nb/io-nb) 


is displayed, giving the number of logged events over the number of input/output 
operations (and the corresponding percentage). 


If the threshold declared at generation proves to be unrealistic, the value can be 
revised for a device class through the MODIFY DEVICE TRACE command. The 
operator can ascertain the present value set for a device class (or all classes) by 
using the DISPLAY DEVICE TRACE command, which also displays the number 
of events detected so far for each device of the class (or all classes). The number of 
events can be reset to zero by use of the MODIFY ERROR LOG command or by 
use of the PRLOG utility. 


It may also be appropriate at some time (with the help of the Service Center, for 
instance) to use the START_DEVICE_TRACE command, which requests an 
information message each time an event is detected. A TERMINATE DEVICE _ 
TRACE command discontinues this activity. 


The START_DEVICE_ TRACE command causes the following message to be 
displayed for the original I/O incident and for the last retry of the I/O operation. 


AV17 dvnm IOCC = ioccvl EV = evvl PSB = psbvl DBS = dsbvl 


The Device Trace commands are described in Chapter 8 Description of the 
Operator Commands. 
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7. Description of the Operator Commands 
(Part 1) 


7.1 Introduction 


7.1.1 GCL Operator Commands 


The whole set of operator commands has been redesigned using the GCL syntax. 


This section describes the GCL commandsmost used by the GCOS 7 system 
console operator. 


The command parameters can be specified in two ways: 


e asa keyword parameter, that is, a keyword, followed by an equals sign and the 
parameter value, 


e asa positional parameter, that is, just a parameter value with no keyword. 


NOTE: 
The conventions, notations and rules used to define the syntax of GCL 
commands are in the Preface. 
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7.1.2 Network Commands 


The following Network Operator commands are described briefly in Section 4.8 
Managing the Network. 


They are fully described in the GCOS 7 Network User's Guide. 


DISPLAY MAILBOX (DMBX) 
DISPLAY NETWORK (DNET) 
DISPLAY TELECOM SERVER (DTSVR) 
MODIFY NETWORK (MDNET) 

MODIFY QUEUE EDIT (MDQED) 

SEND QUEUE (SNDQ) 
START TELECOM SERVER (STSVR) 
START TELECOM TRACE (STTR) 
TERMINATE TELECOM SERVER (TTSVR) 
TERMINATE TELECOM TRACE (TTTR) 
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7.1.3 TDS Commands 


The following TDS commands are described in the TDS Administrator's Guide: 


ALLOW _NEW_TDS COR (ALNTC) 
CANCEL TDS COR (CTC) 
CANCEL TDS SPAWN (CTSPW) 

CHECK _TX_ CONVERSATION (CKTXCONV) 
CLOSE_COR_ POOL (CLCPOOL) 
CLOSE_TDS FILE (CLTF) 

DISPLAY TDS (DTDS) 

DISPLAY TX (DTX) 

DUMP_TDS (DPT) 


EXEC_TDS (EXECT) 
HELP 
LIST_COR_POOL (LSCPOOL) 

LIST TDS COR (LSTC) 

LIST TDS FILE (LSTF) 

LIST_TDS SPAWN (LSTSPW) 
LOAD TDS IQS (LDTIQS) 
LOAD _TDS MEMORY (LDTMEM) 
MODIFY COR _POOL (MDCPOOL) 

MODIFY TDS (MDTDS) 

MODIFY_TDS MOT (MDTMOT) 

MODIFY_TDS RESTART OPTION (MDTRSO) 
MODIFY_TX 
OPEN _COR_POOL (OCPOOL) 
OPEN TDS FILE (OTF) 
PREVENT NEW TDS COR 
SEND_TDS (SNDT) 
SEND_TDS USER (SNDTU) 
SUPERVISE_TDS 

TERMINATE TDS (TTDS) 
UNLOAD_TDS IQS (UNLDTIQS) 
UNLOAD_TDS MEMORY (UNLDTMEM) 
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7.2 


Alphabetical List of GCL Commands 


The commands described in this section are listed below with an indication of the 
type of operators to which they apply. The notation is as follows: 


A Any operator (IOF) 
M Main operator only 
S Both Main and Station operators 


ATT (ATTACH CATALOG) 
ATTACH (ATTACH CATALOG) 
ATTACH CATALOG 


> PP 


CANCEL DUMP 

CANCEL JOB 

CANCEL OUTPUT 

CANCEL REQUEST 

CANCEL TERMINAL OUTPUT 
CANCEL USER_REQ 

CDP (CANCEL DUMP) 

CJ (CANCEL JOB) 

CNDIM (CONNECT DIMENSION) 
CNFUNC (CONNECT_FUNCTION) 
CNLD (CONNECT LOAD) 

CO (CANCEL OUTPUT) 
CONNECT_DIMENSION 

CONNECT_ FUNCTION 
CONNECT_LOAD 

CR (CANCEL REQUEST) 

CRCXGEN (CREATE COMPLEX GENERATION) 
CRDIM (CREATE_DIMENSION) 
CREATE COMPLEX GENERATION 
CREATE DIMENSION 

CREATE FILTER 

CREATE FILTER SET 

CRFLT (CREATE FILTER) 
CRFLTST (CREATE FILTER SET) 
CTO (CANCEL TERMINAL OUTPUT) 
CUR (CANCEL USER_REQ) 


Seprrsprpe 


= 


PPE SS SES SESS SES EVES 


DARS (DISPLAY ARS) 

DASGF (DISPLAY ASSIGNED FILES) 
DASGMIR (DEASSIGN MIRLOG FILE) 
DC (DISPLAY CONFIGURATION) 
DCLC (DISPLAY CLC) 

DCLOG (DISPLAY CONSOLE LOG) 
DCLX (DISPLAY CLX) 

DCX (DISPLAY COMPLEX) 

DDIM (DISPLAY DIMENSION) 


SS SSP VP Ssvrp 
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DDJP (DISPLAY DJP) 

DDP (DISPLAY DUMP) 

DDTIME (DISPLAY DEVIATION TIME) 
DDVTR (DISPLAY DEVICE TRACE) 
DDYNSVR (DISPLAY DYNSAVE_ SVR) 
DEASSIGN MIRLOG FILE 
DELETE_DIMENSION 

DELETE FILTER 
DERLOG (DISPLAY ERROR_LOG) 

DFUNC (DISPLAY FUNCTION) 

DGC (DISPLAY GCL CACHE) 

DHW (DISPLAY HARDWARE CONFIGURATION) 
(DISPLAY IO CACHE) 

IOF (DISPLAY IOF) 
ISCONNECT_DIMENSION 
ISCONNECT_FUNCTION 

ISCONNECT_LOAD 
ISDIM (DISCONNECT DIMENSION) 
ISFUNC (DISCONNECT FUNCTION) 
ISLD (DISCONNECT_LOAD) 
ISPLAY ARS (DARS) 

ISPLAY ASSIGNED FILES 
ISPLAY CLC 
ISPLAY CLX (DCLX) 

LAY COMPLEX 

ISPLAY CONFIGURATION 

PLAY CONSOLE LOG 

PLAY DEVIATION TIME 

ISPLAY DEVICE TRACE 

PLAY DIMENSION 

ISPLAY DJP 

ISPLAY DUMP 

PLAY ERROR_LOG 

PLAY FUNCTION 
PLAY GCL CACHE 

PLAY HARDWARE CONFIGURATION 
[SPLAY IO CACHE 

ISPLAY IOF 

ISPLAY JAS 

ISPLAY JOB 

ISPLAY LOAD 

ISPLAY MEMBER 

ISPLAY MIRROR_MODE 

ISPLAY MOT 

ISPLAY OUTPUT 

ISPLAY POWER_TIMER 

ISPLAY REGULATION PARAMETER 
ISPLAY REQUEST 

ISPLAY RESTART OPTIONS 

ISPLAY RMS 

ISPLAY SECURITY OPTIONS 


1 
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SS SPP SP SSSPPPPSP SP PPP SSP SP SSHPKPVPV SSS SES SHPSPSESESPSES SESS VP 


chetetoReMetoBetotoReBoMe—stek=—s—o—=—stct=seoteRetepetepepetepohetepoRonons 
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SPrprrss Ss SPP SP SEPSSPPPsSsSS SS SPP PsrPrrrsevrvrss 


Sppprrrpprprpp 


Is 
Is 
Is 
Is 


H 
n 
ae) 


H 
n 


Is 
Is 
Is 
Is 


YVOUUNDUNNUY 


jw) 
q 


DLD 
DLD 
DLF 
DMB 


DO 
DPR 
DPR 


DR 
DRM 
DRP 


DS 
DSF 
DSO 


DSS 
DSY 
DTO 
DTM 
DIW 
DUR 
DXL 


ag 
wm 


HOA 


4 4 


eal 


NT: 


EXE 
EXE 


om 
| 
w 


PLAY SERVICE 
PLAY SSI (DSST) 

PLAY STORAGE FACILITIES 
PLAY SUBMITTER 

LAY SYSTEM TRACE 

PLAY TERMINAL OUTPUT 
PLAY TERMINAL WRITER 
PLAY TIME 

PLAY USER_REQ 
PLAY XL CLASS 

(DISPLAY JOB) 


DJAS (DISPLAY JAS) 


(DISPLAY LOAD) 
IM (DELETE DIMENSION) 
LT (DELETE FILTER) 

(DISPLAY MEMBER) 


DMIR (DISPLAY MIRROR_MODE) 
DMOT (DISPLAY MOT) 


(DISPLAY OUTPUT) 
(DPRINT) 
INT 


DPWR (DISPLAY POWER _TIMER) 
DPWRIM (DISPLAY POWER TIMER) 


(DISPLAY REQUEST) 
S (DISPLAY RMS) 


(DISPLAY SUBMITTER) 


(DISPLAY SECURITY OPTIONS) 


DSRV (DISPLAY SERVICE) 


I (DISPLAY SSI) 

STR (DISPLAY SYSTEM TRACE) 
(DISPLAY TERMINAL OUTPUT) 
(DISPLAY TIME) 

(DISPLAY TERMINAL WRITER) 
(DISPLAY USER _REQ) 
( 


C (DISPLAY XL CLASS) 


FIR (ENTER _FILETRANS REQ) 
( 


ENTER_JOB_ REQ) 
(ENTER _JOB_REQ) 
(ENTER _LIBTRANS REQ) 
R_FILETRANS REQ 
R_JOB_REQ 

ER LIBTRANS REQ 

LS (EXEC CLS COMMAND) 
IR (EXECUTE DIRECTIVE) 
C_CLS COMMAND 

C_CLX VOLRPT (VOLRPT) 


E 
E 


(DISPLAY REGULATION PARAMETER) 
DRSO (DISPLAY RESTART OPTIONS) 


(DISPLAY STORAGE FACILITIES) 
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FJ (FORCE_JOB) 

FO (FORCE OUTPUT) 
FORCE_JOB 
FORCE_OUTPUT 
FORCE SERVER_TIMEOUT 
FORCE _USER_REQ 


FSVRTO (FORCE SERVER _TIMEOUT) 


FUR (FORCE USER_REQ) 


GET _CLX FILE (GTCLXF) 
GTCLXF (GET_CLX FILE) 


HGC (HOLD _GCL_ CACHE) 

HJ (HOLD JOB) 

HO (HOLD OUTPUT) 

HOLD _GCL_ CACHE 

HOLD_JOB 

HOLD OUTPUT 

HOLD TERMINAL OUTPUT 

HOLD _USER_REQ 

HTO (HOLD TERMINAL OUTPUT) 
HUR (HOLD USER_REQ) 


INIT SYSTEM TRACE 
ISYSTR (INIT SYSTEM TRACE) 


LIST DUMP 

LIST FILTER 

LSDP (LIST DUMP) 
LSFLT (LIST FILTER) 


[DC (MODIFY_CONFIGURATION) 
[DCLC (MODIFY CLC) 
[DCLX (MODIFY _CLX) 


NDDIM (MODIFY DIMENSION) 


NDDJP (MODIFY DJP) 


[DERLOG 


(MODIFY_ERROR_LOG) 
[DFLT (MO 


IFY_ FILTER) 


S| 
Es 
z 
5 
S) 


tea 


IFY_IO_ CACHE) 
IDIOF IFY_IOF) 
[DIR (MODIFY _INPUT_ READER) 
[DJ (MODIFY_JOB) 
[DLD (MODIFY LOAD) 
[DMIR (MODIFY _MIRROR_MODE) 
[DMOT (MODIFY MOT) 
IDO (MODIFY OUTPUT) 


M 
D 
I 
D 
D 
I 


ae 
- 
MG 
- 
ae 
Me 
- 
Ne 
Wi 
MDIOC 
ve 
Ne 
Ni 
Wi 
Wi 
Wi 
Wi 
WA 
Wi 


IDPWR (MODIFY POWER _TIMER) 


[DDVTR (MODIFY DEVICE TRACE) 


Y HARDWARE CONFIGURATION) 


(DOM (MODIFY OPERATING MODE) 
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DPWRIM (MODIFY POWER _TIMER) 
DRSO (MODIFY RESTART OPTIONS) 
DST (MODIFY STATION) 
DSYSTR (MODIFY SYSTEM TRACE) 
DTIME (MODIFY TIME) 
MODIFY TIME) 
MODIFY TERMINAL OUTPUT) 
©) 
©) 


G8 
i 8 


MODIFY TERMINAL WRITER) 
UR (MODIFY _USER_REQ) 

VV (MODIFY _VOLUME) 

XLC (MODIFY _XL CLASS) 
IFY_CLC 
CLX (MDCLX) 
CONFIGURATION 


is} 


SEE SESESSESESES 
“9338 


ss 
O 

U Oo 

es 


KS 
we) 

1 

Hy t 
ui 


cK 
O 
Ht 


cK 
Oo 
; 


cK 
O 
H +t 
Hy 
K 


IFY_ERROR_LOG 

IFY FILTER 

IFY HARDWARE CONFIGURATION 
IFY_ INPUT READER 
IFY_ IO CACHE 

IFY_IOF 
IFY_ JOB 
IFY_ LOAD 

IFY_MIRROR_MODE 

IFY MOT 

IFY OPERATING MODE 

IFY_ OUTPUT 

IFY POWER TIMER 

IFY RESTART OPTIONS 

IFY STATION 

IFY SYSTEM TRACE 

IFY TERMINAL OUTPUT 

IFY TERMINAL WRITER 

IFY_TIME 

IFY_USER_REQ 

IFY_ VOLUME 

IFY XL CLASS 

MSYSTR (MODIFY SYSTEM TRACE) 

MWENVT (Modify Working Environment) 


Ss 
Oo 
a 


SSSBES 
Heo 


KS 
O 
1 


ZEZRZRBEZBRZERBEEBEE: 
HHH eee 


KS 
O 
1 


z 
OOO Om Om Om Om Om Om Om Omen eme) 8 OO O' OO: OO © :O°O: 0: ©: 
1 


0 
1 


peSSPSPPSHSSPSSs<SSpSeseSesPSSPSSPSnsevsseerospesenee 
Zz z 


Ss 


NAME VOLUME 
NV (NAME VOLUME) 


KS 


RELEASE GCL CACHE 
RELEASE JOB 

RELEASE OUTPUT 

RELEASE TERMINAL OUTPUT 
RELEASE USER REQ 

REP (REPLY) 


PrPrrrs 
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REPLY 
RESYNC_MIRROR_SHARED 

RGC (RELEASE GCL CACHE) 

RJ (RELEASE JOB) 

RO (RELEASE OUTPUT) 

RSCMIR (RESYNC_MIRROR_SHARED) 
RTO (RELEASE TERMINAL OUTPUT) 
RUR (RELEASE USER REQ) 


SARS (START ARS) 

SCLC (START CLC) 

SCLOG (START CONSOLE LOG) 
SCLX (START_CLX) 

SCMSR (START_CMSR) 

SDV (START DEVICE) 

SDVTR (START _DEVICE_TRACE) 
SDYNSVR (START_DYNSAVE_SVR) 
SEND 

SEND_ERROR_LOG 

SERLOG (START _ERROR_LOG) 
SHC (START HARDCOPY) 

SIOC (START_IO_CACHE) 

SIR (START_INPUT_READER) 
SLD (START LOAD) 

SMB (START MEMBER) 

SNDERLOG (SEND_ERROR_LOG) 
SPWRIM (START _POWER_TIMER) 
SO (START _OUTPUT_WRITER) 
SOW (START _OUTPUT_WRITER) 
SRMS (START RMS 
SSRV (START SERVICE) 
SSSI (START _SSI 
SSYSTR (START _SYSTEM_ TRACE) 
TART ARS (SARS 
TART_CLC 


TART CLX (SCLX 


TART CMSR 


TART _CONSOLE_LOG 
TART DEVICE 

TART DEVICE _TRACE 
TART ERROR _LOG 
TART HARDCOPY 


TART_INPUT_READER 
TART _IO_CACHE 
TART LOAD 


TART MEMBER 
TART OUTPUT WRITER (SO) 


TART POWER TIMER 
TART RMS 


TART SERVICE 


TART SSI (SSST) 
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START SYSTEM TRACE 
START TERMINAL OUTPUT 
START TERMINAL WRITER 


STO (START TERMINAL OUTPUT) 
STW (START TERMINAL WRITER) 


TAKEOVER MEMBER 


TARS 
TCLC 
TCLX 


TCLOG (TERMINATE CONSOLE LOG) 


(TERMINATE ARS) 
(TERMINATE CLC) 
(TERMINATE CLX) 


TCMSR (TERMINATE CMSR) 


TDVTR (TERMINATE DEVICE TRACE) 
(TERMINATE DYNSAVE_ SVR) 
TERLOG (TERMINATE ERROR LOG) 


TDYNSVR 


TERMINATE ARS (TARS) 
TERMINATE CLC (TCLC) 
TERMINATE CLX (TCLX) 
TERMINATE _CMSR 
TERMINATE CONSOLE _LOG 
TERMINATE DEVICE TRACE 
TERMINATE _ERROR_LOG 
TERMINATE HARDCOPY 
TERMINATE INPUT _READER 
TERMINATE IO CACHE 


TERMINATE LOAD 


TERMINATE MEMBER 
TERMINATE OUTPUT WRITER 
TERMINATE POWER TIMER 
TERMINATE RMS 

TERMINATE SERVICE 
TERMINATE SSI (TSSI) 
TERMINATE SYSTEM 
TERMINATE SYSTEM TRACE 
TERMINATE TERMINAL OUTPUT 
TERMINATE TERMINAL WRITER 


TEST DEVICE 

THC (TERMINATE HARDCOPY) 

TIOC (TERMINATE IO CACHE) 
TIR (TERMINATE INPUT READER) 
TLD (TERMINATE LOAD) 

TMB (TERMINATE MEMBER) 

TOW (TERMINATE OUTPUT WRITER) 
TPW (MODIFY POWER TIMER) 
TPWRIM (TERMINATE POWER TIMER) 
TRMS (TERMINATE RMS) 

TSRV (TERMINATE SERVICE) 

TSSI (TERMINATE SSI) 


TSYS 


TSYSTR (TERMINATE SYSTEM TRACE) 


Tr 


al 
TSTDV (TEST DEVICE) 
T 


(TERMINATE SYSTEM) 
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The following commands are also accessible to all operators: 


> Pp > PP Pp 


PPP Pp 


DP Pp 


This last set of commands is not detailed in the present manual. Refer to the JOF 
Terminal User's Reference Manual Part II for a complete description. 


TTO (TERMINATE TERMINAL OUTPUT) 
TTIW (TERMINATE TERMINAL WRITER) 


UNLMIR (UNLOCK MIRROR_VOLUME) 
UNLMIRF (UNLOCK MIRLOG FILE) 


UNLOCK MIRLOG FILE 
UNLOCK MIRROR_VOLUME 
UNPATR_ MIRROR_VOLUME 


UNPMIR (UNPAIR MIRROR_VOLUME) 


VOLRPT (EXEC _CLX VOLRPT) 


AI (ALTER INPUT) 
ALTER INPUT 


BYE 


CALL 
COM (COMM) 
COMM 


DELETE GLOBAL 
DISPLAY PROFILE 
DLGB (DELETE GLOBAL) 
DP (DISPLAY PROFILE) 


EJECT 


GB (GLOBAL) 
GLOBAL 


LET 

LIST GLOBAL 

LOG 

LSGB (LIST GLOBAL) 


MDOM INT (MODIFY OPERATING MODE INT) 


MDP (MODIFY PROFILE) 
MODIFY PROFILE 
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7.3 Using the GCOS 7 Help Mechanism 


The help mechanism is one of the most frequently used forms of documentation on 
DPS 7000 systems. It is described in more detail in the multi-volume JOF Terminal 
User's Reference Manual. 


Types of Console 
Local Console: The help texts are available as described below. 


Other Consoles: Synchronous Telecom terminals can sometimes be used as MAIN 
OPERATOR consoles. This gives access to formatted help screens. These are 
completely described in the JOF Terminal User's Reference Manual. 


Using GCOS 7 Helps 


The GCOS 7 helps are called by entering a question mark (?). Using the DERLOG 
command as an example, it would look like this: 


S: ?DERLOG 


Putting the question mark in front of the command gives a text explaining the 
command. In this case, there is a four-page text about the DERLOG command. But 
the most useful feature of GCOS 7 helps are the menu prompts, obtained by putting 
the question mark after the command: 


S: DERLOG? 
DISPLAY ERROR LOGGING 
OPTION STATE, LAST, SET, PRINT (PRINT) : 


7-12 47 A2 53US 


Description of the Operator Commands (Part 1) 


You are then prompted to key in each one of the command's parameters. The first 
parameter of DERLOG command is OPTION; its default value is PRINT. 


Key in: 


For a help text about the current parameter (OPTION in the example). 
<ENTER> To select the default value (PRINT) and to go on to the next parameter. 
or 


<TRANSMIT 


> 
To cancel the command and go back to S: 


(Does not work if the parameter is mandatory.) 
a ie 
parameters 


selected some values and have changed your mind. 
1 or 0 Yes or No. Only works if prompt finishes with a question mark, such as: 
ABN abnormal termination? 


The value to give to the parameter 
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7.4 


7.4.1 


7.4.2 


7.4.3 
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Detailed Description of GCL Commands 


In the following pages each GCL command, in alphabetical order, is fully 
described under the following headings: 


e Purpose, 
e Syntax, 

e Parameters, 
e Rules, 

e Examples. 


Command Prefixing 


Operators can prefix commands with a station-name as follows: 


ALL/command for information on jobs at all stations. 
MAIN/command for information on jobs at the main station. 
STNx/command for information on jobs at the named station: STNx. 


Refer to the JOF Terminal User's Reference Manual, Part 1. 


Three Levels of Command Syntax 


GCOS 7 commands have two standard forms: 


1. The full command (verb_object): ATTACH CATALOG 
2. The abbreviation: ATT 


3. Sometimes there is a third possible command syntax. This is most often a 
previous syntax that has been left intact for the convenience of users who 
have the habit of using it. 


Hidden Parameters or Commands 


Certain commands and parameters, usually those that are rarely used, are not 
included in the menu and/or prompt mechanism. The parameters or commands in 
this category are listed in this section below a dashed line: - - - ------------- 


You have these parameters listed in the menu by entering a plus (+) after its name, 
rather than a question mark (?). There are no help texts for these parameters. 
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7.5 "A" To "C" Commands 


7.5.1. ATTACH_CATALOG (ATT) (ATTACH) 


Purpose 


Indicates to the system that in the following commands any reference to a 
cataloged file must be looked for in the specified catalog. 


Syntax 
{ ATTACH CATALOG } 
{ ATT 
{ ATTACH } 


[CAT = file78] 


Parameters 

CAT The identification of the catalog in which references to 
cataloged files must be looked for. When omitted, the 
effect of any previous ATTACH CATALOG command 
is negated and SITE.CATALOG is assumed again. 

Rules 


e The name of the catalog must end with .CATALOG. When not so, this suffix is 
automatically assumed. 


e The command ATTACH_CATALOG entered without parameters, cancels the 
effect of any previous ATTACH_CATALOG CAT=<catalog-name>. 


e But it has no effect in the MAIN OPERATOR environment on catalogs 
automatically attached by a MWINLIB command. (This is assuming that the 
catalog in question was created with the AUTOATT attribute, and therefore that 
the assignment of one of the cataloged files implies the attachment of the 
catalog). In the MAIN OPERATOR environment, the only way to detach an 
auto-attachable catalog is to log off. 
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Examples 


ATT PR3.CATALOG:VOL6 :MS/B10 
{use catalog PR3.CATALOG on DEVCLASS volume 


VOL6} 
ATT CAT6 {use catalog CAT6.CATALOG on a resident volume} 
ATT {cancel the effect of any previous 


ATTACH_CATALOG; revert to SITE.CATALOG 
(or automatically attached catalog)! 
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7.5.2 CANCEL_DUMP (CDP) 


Purpose 


Cancels a binary dump. The main operator and an IOF user working under project 
SYSADMIN can cancel any dump. Other users can cancel dumps pertaining to 
jobs for which they are submitter or user. For further information, refer to 
Appendix B Index of Commands by "Object". 


Syntax 


{ CANCEL DUMP } 


{ } 
} 


{ CDP 
DUMP_ID = { Xnnnn[:dsn[:dpindex ]] | ALL | * } 

Parameters 

DUMP_ID identifies the dump or dumps to be cancelled. Xnnnn 
specifies the RON (Run Occurrence Number) of the 
job; dsn is the dynamic step number (default is all 
dumps for the RON); and dpindex is the number of the 
dump within the step (default is all dumps within the 
step). If ALL or "*" is specified, all dumps of 
SYS.SPDUMP are cancelled. 

Constraints 

None. 

Examples 

CDP X5432 {cancel all dumps of job X5432} 

CDP ALL {cancel all dumps of SYS.SPDUMP} 

CDP X654:3:5 {cancel the dump whose RON is X654, dynamic step 


number is 3, and dpindex is 5} 
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7.5.3 CANCEL_JOB (CJ) 


Purpose 


Cancels the execution of one or more jobs. A job may be cancelled by its submitter, 
its USER and by main or station operators. Only a main operator can cancel a job 
that is not attached to his station. A station operator may cancel only jobs that are 
linked to his station. A main operator's IOF can be cancelled only by a main 
operator in IOF using the CJ command with the RONS parameter. 


Syntax 

{CANCEL JOB} 
{Co } 
{TJ } 


[RONS = (ron [ron] ...)] 


[{SELECT}  {jclass}[ {usernm}[ {projnm}]]] 


{ }= { }O/{ }I/{ 
[{SEL } {* ae aes 


[ {1}] 
[STRONG = { }] 
[ {0}] 
[ {1}] 
[FORCE = { }] 
[ {0} 


[ {1}] 
[DUMP = { }] 
[ {0}] 
[{MssGc} ] 
[{ } = char255] 
[{MsG } ] 
[{SYSTEM} ] 
[{ } = name4] 
[{sys  } ] 


[JOBSTATE = ALL|SCH|EX|SUSP| IN| HOLD] 
[JOBNAME = names] 
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Parameters 


RONS 


SELECT 


STRONG 


FORCE 


ENDSTEP 


DUMP 


MSSG 


SYSTEM 


JOBSTATE 


JOBNAME 
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a list of up to 16 Run Occurrence Numbers of jobs to 
be cancelled. 


restricts the scope of the command to the jobs that 
belong to the specified combination of 
class/username/project. SELECT=* cancels all jobs 
that are not executing or suspended (this is to avoid 
that the jobs should be cancelled in incoherent states). 
Special care should be taken when using this option. 


if 1, jobs are cancelled and terminate abnormally 
regardless of whether the jobs are repeatable or not, 
and regardless of their internal logic (neither JUMP 
nor any further STEP orders are taken into account). 
Default is 0. 


if 1, jobs terminate abnormally, even if executing their 
exit routines. Default is 0. 


if 1, cancellation is deferred until completion of the 
current step. Jobs then abort regardless of their internal 
logic (neither JUMP nor any further STEP orders are 
taken into account). Default is 0. 


if 1, a dump is generated, even if not requested in the 
control language. 


if 0, no dump is generated, regardless of the control 
language. 


if not specified, a dump is generated or not, according 
to the STEP option. For IOF jobs, no dump is 
generated. 


the text of a message to be included in the Job 
Occurrence Reports of the cancelled job(s). 


indicates the system where the command will be 
executed. 


jobs to be cancelled by current state; jstate must be one 
of the following: ALL, SCH, EX, SUSP, IN, HOLD. 


jobs to be cancelled by name (name-8). 
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Rules 


When RONS is used, neither SELECT, JOBNAME nor JOBSTATE can be used. 
Either RONS, SELECT, JOBNAME or JOBSTATE must be specified. 


When STRONG=!1 FORCE must not be 1. 
When STRONG=1 ENDSTEP must not be 1. 
When FORCE=1 ENDSTEP must not be 1. 


An IOF MAIN operator may cancel the IOF of another MAIN operator if he gives 
the IOF RON (Run Occurrence Number). If the SELECT keyword is used, the 
MAIN operator's IOF jobs will not be cancelled. 


NoTE: 
The effect of a CJ command depends on its issuer and on the job it is aimed at: 


if a job is in critical section when the CJ command is issued, its cancellation is 
deferred until the job exits critical section. 


a job cannot cancel itself unless the ENDSTEP parameter is used. 
only main and station operators may cancel a job that they did not submit. 


only a main operator may cancel a job that is not attached to the same station as 
he is. A station operator may only cancel jobs linked to his station. 


most service jobs cannot be cancelled by a CJ command. Some of them can be 
terminated by specific operator commands (for example 
TERMINATE_SYSTEM_TRACE for TRCCL job, TERMINATE_OUTPUT_WRITER for 
WRITER jobs; refer to the System Operator's Guide or to specific server 
documentation), others cannot be terminated during a session and are stopped 
only by system shutdown (e.g. LAEH, VCAM). 


main operator's IOF can be cancelled only by another main operator in IOF 
using the CJ command with the RONS parameter. 
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Examples 

CJ X123 {cancel one job} 

CJ (X123 X42 X57) {cancel a series of jobs} 

CJ X123 DUMP {cancel and force a dump} 

CJ X123 DUMP=0 {cancel and suppress dump} 

CJ X123 FORCE=1 {cancel, even if in exit routine} 

CJ X123 ENDSTEP MSG='I DID IT BECAUSE OF CONFLICT WITH X324' 


CI 


CI 


CI 


{cancel at end of step and inform with a message} 


SEL=AA {cancel all jobs in class AA} 
SEL=* / JONES {cancel all jobs of user JONES} 
SEL=M JOBNAME=TEST1 JOBSTATE=EX 


{cancel jobs named TEST1 which are in execution in 
job class M} 
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7.5.4 CANCEL_OUTPUT (CO) 

Purpose 

Cancels the request that an output or set of outputs be printed. The outputs cannot 

be recovered after they have been cancelled. 

12s IMPORTANT: 
. This command applies only to the outputs on which the submitter has access 
rights 

Syntax 

{ CANCEL OUTPUT  } 

{ CO } 
[ { (output14 [ outputl14 J )}] 
[ OUTPUT = { output14-output14 }] 
[ { * | ALL } 1 
[ SELCLASS = a [-a] ] 
[ STRONG = { bool | 0 } ] 
[ { STATION } { * }] 
Ea }= {ann }] 
[ { st } = { names } J 
[ { SELECT } { user/project } ] 
CA } = { */project =} J 
[ { ee ae } J 
[ { SEL ee ee fol 
[ { JOBNAME } ] 
[ { } = name8 ] 
[ { JNM } ] 
[ { SYSTEM } ] 
[ { } = name4 ] 
[ { sys } ] 
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Parameters 


OUTPUT 


SELCLASS 


STRONG 


STATION 
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Output(s) to be cancelled. The following formats are 
allowed: 


1. a list of the names of up to 16 outputs: 
- Xnnnn:nnnn } to refer to a specific 
output 
} (Xnnnn:name means 
the first 
- Xnnnn:name_ } output so named) 
- Xnnnn to refer to all outputs 
of a job. 
2s a range of outputs delimited by a lower and 


an upper boundary. This may take the 
following form only: 

- Xnnnn-Xnnnn _ to refer to all outputs 
of a range of jobs; the first ron must be 
lower than the second. 


3. to refer to all outputs of all jobs, specify: 
- * or ALL 
(default when JOBNAME is specified 


(meaningful only for output names in the form Xnnnn) 
restricts the scope of the command to those outputs 
that belong to a certain class or range of classes. This 
may be expressed as: 


class for a single class 
class-class_ forarange of classes 


where class is a letter in the range A to Z. 
When omitted, all classes are assumed (A-Z). 


if 1, cancel even if outputs are being printed. Default 
is 0. 


restricts the scope of the command to outputs attached 
to the station specified. When omitted or when * or 
ALL is specified, there is no station restriction. 
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SELECT 


JOBNAME 


SYSTEM 


Rules 


restricts the scope of the command to outputs 
belonging to a specified user and/or project. Not 
meaningful when OUTPUT specifies a list of outputs 
(format 1). By default, only the outputs belonging to 
the command submitter are selected. 


restricts the scope of the command to the outputs of 
jobs with the name specified. If JOBNAME is 
specified, the default value for OUTPUT is *. 


indicates the system on which the command is to be 
executed. 


e SELCLASS is ignored for names of specific outputs (Xnnnn: nnnnn or Xnnnn: 


name). 


e Ifseveral outputs of the same job are given the same name, CO Xnnnn: name 
only affects the first output with that name encountered by the system. 


e CANCEL OUTPUT does not apply to outputs in the KNOWN state. 


Examples 

CO X123 

CO (X123 X124) 

CO X123 H 

CO X123 A-S 

CO X123:2 

CO X123: SPR 

CO (X123:1 X123:RES) 


CO X123 STRONG 


CO X123-X2167 


CO * Z 


{cancel all outputs of job X123} 
{cancel all outputs of jobs X123 and X124} 
{cancel all outputs of job X123 that are of class H} 


{cancel all outputs of job X123 that are of classes A 
to S} 


{cancel specified outputs of job X123} 


{cancel all outputs of job X123, even if being printed} 


{cancel all outputs, belonging to the command 
submitter, of the jobs whose RON is in the range X123 
to X2167} 


{cancel all class Z outputs, belonging to the command 
submitter, of all jobs} 
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CO * SELECT=U1/P1 {cancel all the outputs belonging to user U1 of project 
Pl} 
CO * STATION=BC10 {cancel all outputs, belonging to the command 


submitter, that are attached to the station BC10} 


CO X123-X2167 A ST=BC10 SEL=U1/P1 
{cancel all class A outputs of jobs in the range X123 to 
X2167 that are attached to station BC10 and belong to 
user U1 of project P1} 


CO JOBNAME=JOB1 {cancel all outputs, belonging to the command 
submitter, of the jobs named JOB1} 
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7.5.5 
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CANCEL_REQUEST (CR) 


Purpose 
Cancels a system request on a device. This is used to indicate that: 


a request volume cannot or will not be mounted, 

a device will not be switched to WRITE PERMIT, 

there is no recovery to be made following an incident, 

the Output Writer recovery mechanism is requested after an incident on a printer. 


The operator decision is given to the job originating the request. Usually, the job 
aborts. For further details, refer to the sections concerning to the device indicated 
in the request message. 


Syntax 
{ CANCEL REQUEST } 
{ CR } 
{ DEVICE } 
{ DV } 
Parameters 
DEVICE Identification of the device whose request is to be 
cancelled. 
Rules 


Refer to Mirror Disks User's Guide for CR related to a MIRROR disk. 


Constraint 


A mounting or recovery operation performed after CANCEL REQUEST has been 
issued does not stop the effect of the CANCEL REQUEST command. 


Examples 

CR MSO3 {cancel request on disk unit MS03} 
CR PRO4 {cancel request on printer PRO4} 
CR MTO3 {cancel request on tape unit MT03} 
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7.5.6 CANCEL_TERMINAL_OUTPUT (CTO) 


Purpose 


Cancels the request that an output or set of outputs be printed by the Generalized 
Terminal Writer. The outputs cannot be recovered after they have been cancelled. 
Refer to the Generalized Terminal Writer User Guide for a complete description of 
the Generalized Terminal Writer. 


Syntax 


{ CANCEL TERMINAL OUTPUT } 
{ cTO } 


OUTPUT = (Rnnnn [ Rnnnn ] ...) 


[ STRONG = { bool | 0 } ] 


Parameters 

OUTPUT a list of the names of up to 16 outputs to be cancelled. 
Each output name has the form Rnnnn and is provided 
as the result of the DPRINT command (with parameter 
TWDEST). 

STRONG if 1, cancel even if outputs are being printed. 

Rules 

None. 

Examples 

CTO R1234 {cancel output with name R1234} 

CTO (R1234 R1235) {cancel two outputs} 

CTO R1234 STRONG {cancel even if being printed} 
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CANCEL_USER_REQ (CUR) 


Purpose 


Cancels file transfer or jobset requests. 


Syntax 


{ CANCEL USER_REQ } 
{ CUR 


REQUEST = ( name8 [ name8 ] ...) ] 
ALL = { bool | 0 } ] 


[ ALL USERS = { bool | 0 } ] 


[ RELEASE = { bool | 0 } ] 


Parameters 


REQUEST a list of up to 16 names of requests to be cancelled. 
Names start with a letter. Each name may take one of 
the following three forms: 


— Jnnnnnnn a Jobset Occurrence Number (JON) 

— Fnnnnnnn a File transfer Occurrence Number 
(FON) 

— name8 the symbolic name of a request as specified 
by the NAME parameter of the ENTER JOB REQ 
or ENTER FILETRANS REQ commands. 


JONs and FONs are provided as results of the 
ENTER JOB REQ or ENTER FILETRANS REQ 
commands: they are unique identifiers for the 
corresponding requests. 


RELEASE if 1, requests which are waiting for the completion of 
the request(s) being cancelled are released, as if the 
cancelled requests had completed execution. 

If omitted or 0, waiting requests are cancelled as well. 
Default value is 0. 


ALL This parameter enables a user to cancel all of his or her 
own requests. 
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ALL_USERS This parameter can be used by the Main Operator to 
cancel all the requests of all users, or by a Station 
Operator to cancel all requests submitted on behalf of 
the Station. 


Rules 
RELEASE is ignored for jobset requests. 
REQUEST, ALL and ALL_USERS are mutually exclusive. 


Examples 

CUR J18 (Cancel jobset request J18.) 

CUR (F32 J27 RQP) (Cancel three requests.) 

CUR F44 RELEASE (Cancel file transfer request F44 and release waiting 


requests.) 
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CONNECT_DIMENSION (CNDIM) 


Purpose 


Connects Job Classes or Load Modules to a dimension. See the ARM User's Guide 
for full details. 


Syntax 

{ CONNECT DIMENSION } 

{ CNDIM } 
DIM=name8s 
{ { JOBCLASS } } 
{ { }=(name2 [-name2] ,name2 [-name2]...) } 
{ { Jc } } 
{ } 
{ {name2 } {name2 } } 
{ LM=(name31/{ } [,name31/{ BD gest) 4} 
{ * 3 we } 
[ { SYSTEM } ] 
[ { } = name4 ] 
[ { sys } ] 

Parameters 

DIM name of the dimension 

JC list of up to eight job classes or job class groups 


assigned to the specified dimension. 

The hyphen convention means that a list of JCs is to be 
connected to the specified dimension; for instance, 
(AY-BC) means that the job classes named AY, AZ, B, 
BA, BB, BC are to be connected. 


LM list of up to eight couples (load module name/job class 
name). The named LMs are considered as being 
connected to the present dimension if they are issued 
from the associated job class. The star convention 
means that the load module may be issued from any 
job class in the system. 


SYSTEM This parameter indicates the system where the 
command will be executed. 
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Rules 


Available in FULL ARM only. 


JOBCLASS (JC) and LM are mutually exclusive. Either JOBCLASS or LM (but 
not both) must be used. 


AJC or an LM which has already been connected to a dimension cannot be 
connected to another dimension. 


If the first object connected to the dimension is a JC or a set of JCs, further 
attempts to connect LMs are rejected except for the dimension SYS which may 
have both JCs and LMs connected. 


If the first object connected to the dimension is a LM or a set of LMs, further 
attempts to connect JCs are rejected except for the dimension SYS which may 
have both JCs and LMs connected. 


The use of CNDIM does not cancel earlier connections of job class groups or of 
load modules to the same dimension. 


Some LM connections are done automatically on predefined dimensions when 
the system is initialized. They cannot be disconnected using DISDIM command. 


Example 


CNDIM DIM=IOF JC= (A,B,C, AA, BM) 


(Connect the Job Class Groups A,B,C,AA and BM to 
the IOF dimension.) 
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CONNECT_FUNCTION (CNFUNC) 


Purpose 


Connect a privileged function to a given resource domain. When a function is 
connected to a domain, this function can use the CPU resource of the domain. See 
Section 5-10 Domain and CDP Overview. 


Syntax 


{ CONNECT FUNCTION 
{ CNFUNC 


DOMAIN 
FUNCTION 


[ { SYSTEM 
2 


SYS 


Parameters 


DOMAIN 


FUNCTION 


name of the domain. On ARTEMIS1 machines, only 
the domains CDP1, CDP2 and CDP3 can be specified. 
On ARTEMIS2 machines, the domains can be only 
CDP1 and CDP2, depending on the configuration. 


name of the function. This function name is not the 
name of the product. The function names are: 
SYSTEM, ORACLE, OPEN7, IQS, DW7, Y2KTEST, 
OPEN7 Fl and TDS WEB. 


On ARTEMIS2, the OPEN7 function is assigned to the 
domain OPENP and its affectation cannot be changed. 
On ARTEMIS2, configuration B, the OPEN7 F1 
function is assigned to the domain OPENCDP and its 
affectation cannot be changed. 


On ARTEMIS2, configuration A, the OPEN7_F1 
function is not visible. No function can be connected 
explicitly to the domains OPENP or OPENCDP, and 
the functions OPEN7 and OPEN7_F1 cannot be 
connected to any domain. They are always connected 
by the system on their respective domains. 


47 A2 53US 


47 A2 53US 


Description of the Operator Commands (Part 1) 


SYSTEM the system where the command will be executed. 


Rules 


e To connect a function to the domain CDP2 or CDP3, this domain must be free or 
in other words, no other function must be connected to it. 


e No function can be connected to the domain STANDARD (corresponds to IPU 
processors). 


e By default all functions are connected to CDP1. 


e A function can be connected to one and only one domain. 


Examples 


CNFUNC DOMAIN=CDP2 FUNCTION=OPEN7 
When OPEN7 jobs start, they will use the CDP2 CPU 
resources 


CNFUNC DOMAIN=CDP3 FUNCTION=IQS 
When IQS jobs start, they will use the CDP3 CPU 
resources. 


NOTE: 
The CONNECT _FUNCTION, DISCONNECT FUNCTION and 
DISPLAY FUNCTION commands are part of the MAIN GCL domain. 
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7.5.10 _CONNECT_LOAD (CNLD) 
Purpose 
Attaches classes to a class 
Syntax 
{ CONNECT_LOAD  } 
{ CNLD } 
CLASS = aa 
CLASSLIST = 
[ { SYSTEM } 
Us } = 
[ { sys } 
Parameters 
CLASS 
CLASSLIST 
SYSTEM 
7-34 


group. 


(aa[-aa] [aa[-aa]] ...) 


] 


name4 ] 


] 


name of the existing or to be defined class group. 


the list of interval classes to be joined to the class 
group CLASS. Up to 8 intervals can be specified. 


This parameter indicates the system where the 
command will be executed. 
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Rules 


e The command is rejected if a class in CLASSLIST is already a class group. 
e Aclass cannot be connected to several class groups. 


e The value of CLASS cannot be included in CLASSLIST. 


IMPORTANT: 
Some service job classes cannot be connected to a job class group. 


NOTE: 
Any class connected to a job class group assigned to a project by the System 
Administrator is dynamically assigned to the project. 


Example 


CNLD AA B-BZ {attaches the classes B,BA,...BZ to class group AA} 
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7.5.11. CREATE_COMPLEX_GENERATION (CRCXGEN) 


Purpose 


This command is used to describe and generate a COMPLEX. It is normally for 
use of the COMPLEX Administrator. 


Syntax 


{ CREATE COMPLEX GENERATION } 
{ CRCXGEN } 


SOURCE = subfile-name31 
SLLIB = 11b78 


[ ENABLE = { bool | 0 } ] ; 


Parameters 

SOURCE Name of the source subfile which contains the input 
directives of the COMPLEX Description. This subfile 
must be catalogued. 

SLLIB Name of the source library which contains the 
SOURCE subfile. 

ENABLE When ENABLE = 1, the COMPLEX Description is 


syntactically and semantically analyzed, and the 
COMPLEX is generated if these analyses have 
succeeded. 


When ENABLE = 0, only the COMPLEX Description 
is syntactically and semantically analyzed. 


The default is 0. 
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Constraints 


e CREATE COMPLEX GENERATION command must be syntactically correct. 


e Ifa COMPLEX is already started then CREATE _ COMPLEX GENERATION 
(CRCXGEN) command must not be entered with the option ENABLE equal 
to 1. 


Example 


CRCXGEN SOURCE = ABCD SLLIB = P1.MYLIB 
(Generates a COMPLEX using subfile named ABCD 
in library named P1.MYLIB.) 
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CREATE_DIMENSION (CRDIM) 


Purpose 


Creation of a non-predefined dimension. A new dimension is created with the 
current pattern of the named existing dimension. In case the LIKE keyword is not 
used, the dimension is created with the current pattern of the BATCH dimension. 
See ARM User's Guide for full details. 


Syntax 


{ CREATE DIMENSION  } 
{ CRDIM } 


DIM = names 


[LIKE = { name8 | BATCH } ] 


[ { SYSTEM } ] 
[ { } = name4 ] 
[ { sys } ] 
Parameters 
DIM Name of the new dimension. 
LIKE Name of an existing dimension. 
SYSTEM System where the command will be executed. 


Rules 


e the ARM Level must be FULL. 

e the maximum number of Dimensions is 32. 

e the dimension to be created may not be a predefined dimension. 
e the existing dimension named in the command must not be SYS. 


When a Dimension is created, its pattern is identical to the current pattern of the 
LIKE parameter dimension. If LIKE is not used, it is the current pattern of the 
BATCH dimension. 


Example: 


CRDIM POOL4 LIKE=IOF {Create a new dimension, named POOL4, with IOF 
current parameter values} 
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7.5.13 CREATE_FILTER (CRFLT) 
Purpose 
Creates an elementary filter within a filter set. An elementary filter defines a set of 
filtering criteria. A generic message must meet all criteria defined by a filter to be 
acceptable to that filter. The filters belonging to a given filter set are arranged 
according to rules defined by the FLT_TYPE parameter. 
Syntax 
{ CREATE FILTER } 
{ CRFLT } 
{ FILTERSET } 
{ = fltst 
{ FLTST 
{ FILTER } 
{ } = flt 
{ FLT } 
{ FLT TYPE } {1 } 
{ J= {FE} 
{ FTYPE } {m } 
KEY = ( names [ names ] )] 
cee 
TYPE = {R} ] 
eMed 
JOBID = names ] 
RON = Xnnnn ] 
{ SYSTEM } ] 
[ { } = name4 ] 
[ { sys } ] 
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Parameters 


FILTERSET 


FILTER 
FLT_TYPE 


TYPE 


JOBID 


RON 


SYSTEM 
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the name of the filter set to which the filter being 
defined belongs. 


the name of the filter being defined. 
the type of the filter, as follows: 


I inclusive 
E exclusive 
M mandatory. 


A message is acceptable to a filter set if: 


— it meets at least one of its inclusive filters (if any), 
— it meets none of the exclusive filters, 
— it meets all its mandatory filters. 


A message is acceptable to a filter if it meets all 
criteria defined by the parameters KEY, TYPE, JOBID 
and RON. 


the key or inclusive range of keys of the acceptable 
messages. The format of each key is: aaaannnn, where 
aaaa is a string of 2 to 4 alphabetic characters and nnnn 
is the numerical part between | and 4059. Leading 
zeros are eliminated. 


the types of the acceptable messages, as follows: 


* all messages, 

R request messages requiring a reply or a manual or 
non-manual action, 

M messages requiring a manual action. 


identification of the Job issuing the message; the 
messages originate from the load modules. 


NOTE: The JOBID filter parameter is not a criterion 
for most system messages. 


the Run Occurrence Number (Xnnnn) of the Job 
issuing the acceptable messages. 


This parameter indicates the system where the 
command will be executed. 
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Rules 
e One at least of KEY, TYPE, JOBID or RON must be specified. 


e No more than 16 filters may belong to a single filter set. 


e The filter set must be created (by use of the CREATE FILTER SET command) 
prior to creating the filters it is to contain. 


Examples 


CRFLT Al A101 I TYPE=* 
{create inclusive filter A101 within set Al accepting 
all types of messages} 


CRFLT A2 A101 E KEY=(DVO1 DV99) 
{create exclusive filter A101 within set A2 analyzing 
and rejecting all messages with keys in the range 
DVO1 to DV99} 


CRFLT A3 A101 M KEY=(AAO1 ZZ99) TYPE=M JOBID=TEST RON=X29 
{create mandatory filter A101 within set A3 accepting 
all action messages from job TEST with RON X29} 
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7.5.14 CREATE_FILTERSET (CRFLTST) 
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Purpose 


Creates a set of filters. A set of filters consists of a number of elementary filters. 
The combination of several elementary filters belonging to the same filter set 
defines a class of messages that the operator wishes to receive. Filters defined by 
an operator apply only to himself. By default, when no filter is active the operator 
receives no generic message from the system. It is sufficient that a message 
matches one of the defined filter sets to be delivered to the issuer of the command. 


Syntax 
{ CREATE FILTERSET } 
{ CRFLTST 
{ FILTERSET 
= fltst 
{ FLTST 
{ PRIORITY 
= decl 
{ PRTY 
[ { SYSTEM } ] 
[ { } = name4 ] 
[ { sys } ] 
Parameters 
FILTERSET the name of the set of filters to be created. 
PRIORITY the priority of the filter set in the range 0 to 9. The 
lower the value, the higher the priority. 
SYSTEM This parameter indicates the system where the 
command will be executed. 
Rules 


No more than 16 filter sets may be defined for any single operator. 


Example 


CRFST Al 3 {create filter set Al with priority 3} 
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"D" Commands 


DEASSIGN_MIRLOG_FILE (DASGMIR) 


Purpose 


This command is used when resolving SITE.MIRLOG error conditions related to 
the file itself, the volume where it is located or the device containing this volume. 


It is to be used with great caution, normally under the supervision of your Bull 
representative. 


This command is available only if the system has been configured with MIRROR = 
YES. 


Syntax 

{ DEASSIGN MIRLOG FILE } 
{ DASGMIR } 
Parameters 


None. 


Rules 
Refer to Mirror Disks User's Guide. 


Example 


DASGMIR Deassigns the SITE.MIRLOG file and displays the 
message: 


MR19 DEASSIGNMENT OF THE SITE.MIRLOG 
SUCCESSFUL 
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7.6.2 DELETE_DIMENSION (DLDIM) 


Purpose 


Deletes a dimension. See the ARM User's Guide for full details. 


Syntax 


{ DELETE DIMENSION } 
{ DLDIM } 


DIM = names 


[ { SYSTEM } ] 

[ { } = name4 ] 

[ { sys } ] 
Parameters 
DIM name of the dimension to be deleted. 
SYSTEM This parameter indicates the system where the 


command will be executed. 


Rules 


e the predefined (or default) dimensions (SYS, TDS, IOF, and BATCH) may not 
be deleted. 


e the ARM level must be FULL. 


e the command is rejected (message AR85) if there is at least one step allocation 
in the dimension to be deleted. 


Example: 


DLDIM DIM=IOF3 {delete the dimension named IOF3} 
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7.6.3 DELETE_FILTER (DLFLT) 


Purpose 


Deletes a single filter, a set of filters, all filters, or all filter sets that belong to the 


operator. 
Syntax 
{ DELETE FILTER } 
{ DLFLT } 
{ FILTERSET } { * } 
} = { 
{ FLTST } { name2 } 
[ { FILTER 
[ { = name4 ] 
{ FLT ] 
{ SYSTEM 
[ { = name4 ] 
{ SYS ] 
Parameters 
FILTERSET When used alone (without FILTER), specifies the set 
of filters to be deleted (* means all operator defined 
filter sets). When used in conjunction with FILTER, 
specifies the filter set to which the filter to be deleted 
belongs. 
FILTER The name of the filter to be deleted. When omitted, all 
filters that belong to the set of filters named by 
FILTERSET are deleted. 
SYSTEM This parameter indicates the system where the 


command will be executed. 
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Rules 
When FILTERSET is *, FILTER cannot be specified. 


Examples 

DLFT Al A101 {delete filter A101 within filter set Al} 

DLFLT Al {delete all filters of set Al} 

DLFLT * {delete all filters and sets of filters that belong to the 


operator} 
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7.6.4 DISCONNECT_DIMENSION (DISDIM) 
Purpose 
Disconnects Job Class Groups or Load Module(s) from a dimension. See the ARM 
User's Guide for full details. 
Syntax 
{ DISCONNECT DIMENSION } 
{ DISDIM } 
DIM=name8 
[ {JOBCLASS } ] 
[ { } = (aal-aa],[aa[-aa]]..) ] 
[ {gc } 
{name2 } {name2 } ] 
LM= (name31/ { } [,name31/{ }] 2) J 
* * } ] 
[ { SYSTEM } ] 
[ } = name4 ] 
{ sys } ] 

Parameters 

DIM the name of the dimension. 

JC list of up to eight Job Class Groups to be disconnected 
from the specified dimension. If JC=* is specified, all 
the Job Classes are disconnected from the Dimension. 
The hyphen convention means that a list of JCs is to be 
disconnected from the dimension; for instance, (AY- 
BC) means that the job classes names AY, AZ, B, BA, 
BB, BC are to be disconnected. 
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LM list of up to eight couples (load module name/job class 
name). The named LMs are considered as being 
disconnected from the present dimension if they are 
issued from the associated job class. The star 
convention means that the specified load module is no 
longer known to the load module/job class 
correspondence array of the dimensions. If LM=* is 
specified, all the Load Modules are no longer known 
to the Dimension. 


SYSTEM This parameter indicates the system where the 
command will be executed. 


Rules 
e Available in FULL level only. 


e JC and LM are mutually exclusive. One of the two must be specified. 


e LM connections done automatically, on predefined dimensions, during system 
initialization, cannot be disconnected using DISDIM. See the 
CONNECT_DIMENSION command for more information. 


e For both JC and LM, only one value can be specified when * or ALL are used. 


Example 


DISDIM DIM=TDS2 JC=(TA, TB) 


(Disconnect job classes TA and TB from the dimension 
TDS2.) 
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7.6.5 DISCONNECT_FUNCTION (DISFUNC) 
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Purpose 


Disconnect a privileged function from a given resource domain. See Section 5.10 
Domain and CDP Overview. 


Syntax 
{ DISCONNECT_FUNCTION } 
{ DISFUNC } 
DOMAIN = { name-8} 
FUNCTION = { name-8} 
[ { SYSTEM } ] 
[ { } = name-4 ] 
[ { sys } ] 
Parameters 
DOMAIN name of the domain. On ARTEMIS1 machines, only 
the domains CDP1, CDP2 and CDP3 can be specified. 
On ARTEMIS2, the domains can only be CDP1 and 
CDP2, depending on the configuration. 
FUNCTION name of the function. This function name is not the 
name of the product. The function names are: 
SYSTEM, ORACLE, OPEN7, IQS, DW7, Y2KTEST, 
OPEN7 F1 and TDS_WEB. 
On ARTEMIS2, the functions OPEN7 (connected to 
the domain OPENP) and OPEN7_F1 (connected to the 
domain OPENCDP) cannot be disconnected. 
SYSTEM the system where the command will be executed. 
Rules 


e To disconnect a function from a domain, the function must have been connected 
to it and must not be running. In other words, it must have no running Load 
Module for this function. 


e No function can be disconnected from the domain STANDARD (corresponds to 
IPU processors). 
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e When a function is disconnected from CDP2 or CDP3, it is automatically 
connected to the domain CDP1 (default domain). 


e When a function is disconnected from CDP1, it is automatically connected to the 


domain STANDARD. 


Examples 


DISFUNC DOMAIN=CDP2 FUNCTION=OPEN7 


The function OPEN7 is connected to the domain 
CDP2, the command is successfully performed only if 
the OPEN7 jobs are stopped. In other cases an error 
message is sent. 

If the command is completed, the OPEN7 function 
returns to domain CDP 1. 


DISFUNC DOMAIN=CDP1 FUNCTION=I0OS 


NOTE: 


The function IQS is connected to the domain CDP1. 
The command is successfully performed only if the 
IQS jobs are stopped. After execution of this 
command, the function IQS cannot use the resources 
of the CDP1 domain and is connected to the domain 
STANDARD. 


The CONNECT FUNCTION, DISCONNECT FUNCTION and 
DISPLAY FUNCTION commands are part of the MAIN GCL domain. 
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7.6.6 DISCONNECT_LOAD (DISLD) 


Purpose 


Description of the Operator Commands (Part 1) 


Detaches class(es) from a class group. 


Syntax 
{ DISCONNECT LOAD } 
{ DISLD } 
CLASS = aa 
CLASSLIST (aa[-aa] [aa[-aa]]...) 
[ { SYSTEM } ] 
[ { } = name4 ] 
[ { sys } ] 
Parameters 
CLASS name of the class group to be modified. 
CLASSLIST the list of interval classes attached to the class CLASS 
that should be detached (* for all classes). Up to 8 
intervals can be specified. 
SYSTEM indicates the system on which the command will be 
executed. 
Rules 
None. 
Example 


DISLD AA BC-BE 
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{detach classes BC,B D, BE from Class Group AA} 
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7.6.7 
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DISPLAY_ARS (DARS) 


Purpose 


This directive displays the current migration jobs, the activity statistics, and/or the 
configuration parameters of the ASM 7 File Migrator (ARS). 


Syntax 
{ DISPLAY ARS } 
{ } 
{ DARS } 
{ CONFIGURATION 
[ { = bool ] 
{ CONF 
{ STATISTICS 
[ { = bool ] 
{ STAT 
{ RSTFILE 
[ { = bool ] 
{ RSTF 
[ PRTFILE = file78 ] 
Parameters 
CONFIGURATION If 1, displays the current values of the ARS 
configuration parameters. For Migration-in, these are 
the job execution class, time-out period, and operating 
modes. If 0, this information is not displayed. 
STATISTICS If 1, displays statistics about ARS activity. These are 
accumulated values starting from ARS activation to the 
current date. If 0, this information is not displayed. 
RSTFILE If 1, displays the ron, efn, and elapsed time for each 
Migration-in job currently in progress. If 0, this 
information is not displayed. 
PRTFILE The execution report file. 
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Constraints 


e If CONF, STAT, and RSTF are all unspecified, then RSTF=1 applies. 

e If CONF, STAT, and RSTF are all set explicitly to zero, no information is 
displayed. 

e The SYS.OUT value is not allowed for PRTFILE in batch mode. 


Examples 

DARS ; Displays information about the current Migration-in 
jobs. 

DARS CONF STAT; Displays ARS configuration parameters and ARS 


activity statistics. 
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DISPLAY_ASSIGNED_FILES (DASGF) 


Purpose 
Displays on the screen, 
if the RON parameter is used: 


e the list of all the files used by the job (EFN, IFN, and PMD) and for each of 
them, if the DETAILED option is specified, MD, DVC, FILESTAT, and 
CATALOG. 


if the EFN parameter is used: 


e the list of all the RONs of the JOBs having assigned the file. If the DETAILED 
option is used, for each RON, the IFN and the PMD will be displayed. 


Syntax 

{DISPLAY ASSIGNED_FILES} 
{ } 
{DASGF } 


{RON = {output5} | EFN = {char44} 


{DETAILED} 

{ } = {bool | 0 } 

{DTLD } 
Parameters 
RON Run Occurrence Number of the JOB 
EFN The External File Name of the file 
DETAILED Displays more information about files 


If the RON parameter is used: 
=0 Only EFN, IFN, and PMD are displayed 
=1 Assign file characteristics are displayed 


if the EFN parameter is used: 
=0 Only the list of the RONs of the JOBs having assigned the file is displayed 
=1 For each RON, the IFN and the PMD is displayed 
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Constraints 
Parameters RON and EFN are mutually exclusive. 
If the parameter RON is used: 


1. Command right execution: 


— auser that belongs to the SYSADMIN project or to a project having the 
MAIN attribute has all rights; he has the visibility of all JOBs running on 
the system 

— auser that belongs to other projects has only the visibility of the JOBs 
submitted by himself. 


2. The command is only allowed on the JOBs in executing state. 


If the parameter EFN is used: the command execution is reserved to a user 
belonging to the SYSADMIN project or having the MAIN attribute. 


Limits: 
e Ifthe parameter IFN is used with the parameter DETAILED, a maximum of 20 
IFNs per JOB will be displayed. 
The line: 
DEINE yess; oeste PMD= .. 
indicates that more than 20 IFNs are assigned to the EFN given in the parameter. 


e For cataloged tape files on more than 10 media, only the 10 current media are 
displayed. 


Remarks concerning EFN parameter usage: 


The EFN parameter specifies the EXTERNAL FILE NAME of the file. (No 
residency information must appear in this EFN.) 


For a temporary file, the EFN must be followed by $TEMPRY. 


7-55 


GCOS 7 System Operator's Guide 


7-56 


Example 


To display the RONs of the job having assigned the temporary file 
"5102213.TEMP.SLLIB": 


DASGF EFN=TEMP .SLLIBSTEMPRY 


REMARK: 
If several jobs have assigned a temporary file called TEMP.SLLIB, the 
DASGF command will display information for each temporary file. 


For EFNs with a generation number and/or a version number, only the EFN 
syntaxes shown in the example are allowed (G suffix with + or - is rejected). 


Examples 


DASGF EFN=DIR1.FILE/G0001; 
DASGF EFN=DIR.FILE/V01; 


To use the command with a non-standard EFN (EFN with lowercase characters 
with blank characters, etc.) the EFN parameter must be quoted. In these cases, to 
specify the EFN in the input field use: 


e single quote with formatted screen; e.g., for a temporary file ';000635.myefn 
e triple quotes with a serial terminal; e.g., for a temporary file: '";000635.myefn" 


In some cases (CATALOG files assigned by the system and "passed" files) no IFN 
exists associated with the EFN. In these cases, only the RON for which the file is 
assigned will be displayed. 


Examples 
Use of the RON parameter 
DASGF X366 DETAILED=0 
13.07 EFN IFN PMD 
GEF . FILE003 IFNO03 NA 
GEF .ULFA0001 IFNO04 UP 


Displays the list of the files assigned by the RON X366. 


DASGF X366 DETAILED=1 
13.07 EFN= GEF.FILEO003 


IFN= IFNOO03 PMD= NA 
MD= (BFS162, BFS163, BFS164) 
DVC= MS/B10 FILESTAT= UNCAT 
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EFN= GEF.ULFA0001 
IFN= 


IFNO004 PMD= UP 
MD= (BFROAA) 
DVC= MS/B10 FILESTAT= CAT 


CATALOG= GEF .CATALOG:BFU047 :MS/B10 


Displays the list of files assigned by the RON X366, and the detailed information 
for each of them. 


Use of the EFN parameter 


DASGF EFN=DIR1.FILE1 DETAILED=0 


13.14 EFN=DIR1.FILE1 
MD= (BFS162/BFS163/BFS164) 
DVC= MS/B10 FILESTAT= UNCAT 
RON= X1234 X7568 


Displays the list of RONs having assigned the file DIR1.FILE1 


DASGF EFN=DIR1.FILE1 DETAILED=1 
13.16 EFN= DIR1.FILE1 
MD= (BFS162/BFS163/BFS164) 
DVC= MS/B10 FILESTAT= UNCAT 
RON= X1234 
IFN= IFNOO1 PMD= UP 
IFN= IFNOO02 PMD= IN 
RON= X7568 
IFN= INFILE PMD= IN 
IFN= OUTFILE PMD= OU 


Displays the list of RONs having assigned the file DIR1.FILE1 and the detailed 
information for each of them. 
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SH46 


SH46 


SH46 


SH46 


SH46 


SH46 


SH46 
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cmdnm 


cmdnm 


cmdnm 


cmdnm 


cmdnm 


cmdnm 


cmdnm 


NOTES: 


1. 


PMD is the processing mode of the file, that is its state when the DASGF command 


The CATALOG field is optional; it is displayed only when the RON 
parameter is used and if the file is catalogued in a non-auto-attachable 
catalog. 


If the EFN is SYS.OUT or SYS.IN, the MD and DVC are set to RSDT 
(resident) and the PMD is set to NA (non available). 


If the EFN is DUMMY, the MD, DVC and PMD are set to NA. 
For the other EFN, the PMD is set to NA if the file is not opened. 


PMD is set to ?? if an error is detected during access to the file 
management table. 


If the file has been assigned with the residency parameter equal to 
RESIDENT and if it has never been opened, the DVC is unknown and 
only "MS" is displayed. 


If the JOB works with remote files, the PMD of these files is set to RM 
(remote). 


is executed. PMD can be equal to IN (file opened in input), OU (file opened in 
output), UP (file being updated), NA (not available) or RM (remote). 


Error messages: 


UNSUCCESSFUL: UNKNOWN JOB ron (01) 
UNSUCCESSFUL: STATE OF ron MEANINGLESS WITH THE COMMAND (02) 
UNSUCCESSFUL FOR ron gr4 (03) 
NOT ALLOWED FOR ron: SUBMITTER NOT AUTHORIZED (04) 
NOT ALLOWED FOR ron: NO FILE ASSIGNED (05) 
NOT ALLOWED FOR efn: FILE NOT ASSIGNED (06) 
UNSUCCESSFUL FOR efn gr4 (07) 
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7.6.9 DISPLAY_CLC (DCLC) 
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Purpose 


This command, Display Cartridge Library Client, displays the status of devices 
connected to the cartridge library. 


For the selected units, the command displays the volume currently mounted or the 
status of the mount or dismount operation in progress, and also a list of the pending 
mount requests. 


Syntax 
{ DISPLAY CLC } 
{ } 
{ DCLC } 
[ { DEVICE } ] 
[ { } = device ] 
[ { Dv } ] 
Parameters 
DEVICE: When this parameter is present, the status of the 
selected device is displayed. When this parameter is 
not specified, the status of all devices connected to the 
cartridge library is displayed. 
Rules 


The command is rejected if the communications link between the Cartridge Library 
Client (CLC) and the Cartridge Library Server (CLS) has not been established. It is 
also rejected during the CLC initialization phase. 


DEVICE must be the name of a cartridge library device. 


Example 

DCLC (Displays the status of all devices connected to the 
cartridge library.) 

DCLC DEVICE=CT22 (Displays the status of device CT22.) 

DCLC DV=CT22 

DCLC CT22 
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7.6.10 DISPLAY_CLX (DCLX) 


Purpose 


Displays the status of a device or group of devices integrated within the cartridge 
tape library: 


Syntax 


{ DISPLAY CLX } 
{ DCLX } 


[DEVICE = <device> ] 


Parameters 

DEVICE the name of the device. 
If DEVICE is not specified, the status of all devices in 
the cartridge library are displayed. 

Rules 


e The status displayed represents the device status as seen by the CLX. 


e When mounting or dismounting operations are in progress, the information 
displayed by DC and DCLX commands may not be identical: some actions can 
be considered completed by Device Manager whereas they are in progress to 
CLX. 
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S: DCLX 


14.12 TU15 V2.1 
TULS V2.1 CT16 


TULS V2.1 
TULS V2.1 


Cc 
Cc 
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Example 1 


The DCLX command is performed on a system with four drives and two volumes 
mounted. 


CT15 and CT16 are 18-track devices (CT/LIB/MS). The pool identifier 3 is 
associated with CT/LIB/MS devices (18-track formatted WORK volumes). 


CT17 and CT18 are 36-track devices (CT/LIB/36T). The pool identifier 6 is 
associated to CT/LIB/36T (36-track formatted WORK volumes). 


Volume 001863 is dismounted, then remounted. The second DCLX command is 
processed while the dismounting is in progress and the last mount request is 
pending. 


CT15 M5 POOLID = 3 (0,0,1,0) STATUS : 001863 MOUNTED FOR X1981 
M5 POOLID = 3 (0,0,1,1) STATUS : STANDBY 

17 36 POOLID = 6 (0,0,1,2) STATUS : 001864 MOUNTED FOR X1980 

18 36 POOLID = 6 (0,0,1,3) STATUS : STANDBY 


TU14 CLX DISPLAY COMMAND COMPLETED 
* DW10 CT15 DISMOUNT 001863 S 
* 14.13 CT15 MOUNT 001863 LIB FOR X1981 


S: DCLX 

14.13 TU15 CT15 M5 POOLID = 3 (0,0,1,0) STATUS : DISMOUNT 001863 FOR X1981 

IN PROGRESS 

TUL5 V2.1 CT16 M5 POOLID = 3 (0,0,1,1) STATUS : STANDBY 

TUL5 V2.1 CT17 36 POOLID = 6 (0,0,1,2) STATUS : 001864 MOUNTED FOR X1980 

TULS V2.1 CT18 36 POOLID = 6 (0,0,1,3) STATUS : STANDBY 

TULS. V2.D-CTLS.- M5 POOLID = 3 (0,0,1,0) STATUS : MOUNT 001863 FOR X1981 PENDING 
TU14 V2.1 CLX DISPLAY COMMAND COMPLETED 
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Example 2 


Successive DCLX commands are performed while a volume is being mounted, and 
then while the same volume is being dismounted. 


S: DCLX CT17 

15.35) V2.1 TULS CTi?y S6t POOLID = 6 (0,0,1,2) STATUS : STANDBY 
TU14 V2.1 CLX DISPLAY COMMAND COMPLETED 
S: EJ FILSAVE LIB=LCIU.CLX.JCLLIB VL=001863 

15.36 X1887 IN FILSAVE USER=OPERATOR CLASS=P SPR=6 STATION=BCA9 

15.36 X1887 STARTED FILSAVE OPERATOR P 

* 15.36 CT17 MOUNT 001863 LIB FOR X1887 
S: DCLX CT17 
15.36, TU15: V2:.4d.CilT?- S6T POOLID = 6 (0,0,1,2) STATUS : MOUNT 001863 FOR X1887 
IN PROGRESS 
TU14 V2.1 CLX DISPLAY COMMAND COMPLETED 

TU11 V2.1 CT17 IN LIBRARY : 001863 MOUNTED 

JB08 X1887.1 STEP H_ UTILITY XPR=8 PGID=22 
S: DCLX CT17 
15.38 TU15 V2.1 CT17 36T POOLID = 6 (0,0,1,2) STATUS : 001863 MOUNTED FOR X1887 
TU14 V2.1 CLX DISPLAY COMMAND COMPLETED 

* DW10 CT17 DISMOUNT 001863 S 

15.39 X1887.1 COMPLETED FILSAVE OPERATOR P 
S: DCLX CT17 

15.39 TU15 V2.1 CT17 36T POOLID = 6 (0,0,1,2) STATUS : DISMOUNT 001863 FOR X1887 
IN PROGRESS 
TU14 V2.1 CLX DISPLAY COMMAND COMPLETED 

TU12 V2.1 CT17 IN LIBRARY : 001863 DISMOUNTED 
S: DCLX CT17 
15.39 TU15 V2.1 CT17 36T POOLID = 6 (0,0,1,2) STATUS : STANDBY (ACTION TO UNLOCK 
RESOURCE IN PROGRESS) 
TU14 CLX DISPLAY COMMAND COMPLETED 
S: DCLX CT17 
15.40 TU15 V2.1 CT17 36T POOLID = 6 (0,0,1,2) STATUS : STANDBY 
TU14 V2.1 CLX DISPLAY COMMAND COMPLETED 
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7.6.11 DISPLAY_COMPLEX (DCX) 
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Purpose 


Displays information about the whole COMPLEX. This command is a part of the 
High Availability product (HA). For more information, see the High Availability 
Administrator's Guide. 


Syntax 


{ DISPLAY COMPLEX } 
{ DCX } 


Parameters 


None. 


Rules 


The CMSR of the MEMBER on which this command is entered must be running. 


Example 


DCX Displays all information about the COMPLEX. 
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7.6.12 DISPLAY_CONFIGURATION (DC) 


Purpose 


Displays the status of selected elements of the hardware or software configuration. 


Syntax 


{DISPLAY CONFIGURATION} 
{DC } 


a }] 
{ = {device-id }] 
{ DEV } {device-class }] 
[ {device-type }] 
{device-id-char2 }] 


Cee Dl ee Bl oes Be 


[{OUTCLASS} {* }] 

{ b= { }] 

[{oc } {al-al}] 

[ {* }] 

[OUTDV = {PR[nn] }] 

[ {T [nnn] }] 

[ {W[nnn] }] 

[{STATION}  {* }] 

{ } = {ALL fi] 

[{ } = {CURRENT}] 

[{Sst } {names }] 

[ {* }] 
[ PIM = { }] 
[ { [lib-nm..] lm-nm [:volnm :dvc] =nn PAGES YY/MM/DD}] 


[BS = nameé] 


[{VOLUME} = volume 6 : device-class ] 
[{voL  } ] 


[LIB = 11ib78 ] 
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Parameters 


DEVICE display the status of the devices. This may be specified 
as: 


* all devices 
device-id a specified device 

(e.g., MSO3) 
device-type devices of a type (e.g., MS) 
device-id-char2 devices of the same type 

within an interval 

(e.g. CTO1-05) 
device-class all devices that have the 


specified characteristics 
(e.g., MS/B10, CT/S75, 
CT/LIB/MS/C, etc.) 


You can specify all characteristics or only some of 

them: 

CT/36T: all class 36T cartridge tape devices not in a 

library 

CT/LIB: all cartridge tape devices in the library 

CT/C: all devices with the compaction capability, 
whether in a library or not. 


OUTCLASS display the configuration of the output classes (priority, 
output media) and output activities for these classes. 
These may be specified as: 
Bar all classes 
class: a specified class 
class-class: arange of classes 


where class is a letter in the range A to Z. A list of up 
to 10 classes or ranges of classes may be specified. 


OUTDV display the output currently being processed or waiting 
for the specified device (PRnn, Tnnn, or Wnnn), 
device class (PR, T or W), or all writers (*, ic. PR + T 
+W). 
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STATION specifies one of the following: an explicit station 
name, CURRENT (for currently attached stations) or 
ALL or * (for all stations). When used in conjunction 
with OUTCLASS or OUTDY, the information shown 
is restricted to the station concerned (values ALL and * 
are then ignored). When neither OUTCLASS nor 
OUTDYV is specified, information about the 
configuration of the named stations is displayed. 


PLM display information (name, location and number of 
units) about all (*) or a designated pre-initialized load 
module (PLM). A single PLM is designated as follows: 


[lib-name..] Im-name [:volnm :dvc] 


where: 

— lib-name is the library name (default 
SYS.HLMLIB) 

— Im-name is the name of the load module 

— volnm is the volume name (uncataloged library) 

— dvc is the device class of volnm (uncataloged 
library) 

— PAGES is the size of LM 

— YY/MM/DD is the date of the last PLM of this LM 


BS display the status of the required elements of backing 
store. This may be specified as: 


SYS backing store occupation for system, 

ALL backing store occupation for system and all jobs, 
MAP which backing stores are used and on which 
volumes, 

SM loaded sharable modules, 

CKPT active checkpoints, 

VME active Virtual Memory Files, 

IO average number of I/Os per second, 

Xnnnn space used by the named job, 
volume-name jobs that use the volume as backing 
store. 


VOLUME display the status of a volume. The volume must be 
standard. For cartridge, the full device class is needed 
if several models are present on the site. 


LIB display loaded shareable modules in backing store for 
the specified library. Used only with BS = BM. 
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Rules 


None. 


Examples 


DC 


DC 


DC 


DC 


DC 


DC 


DC 


DC 


DC 


DC 


MSA1-B2 


MT 


ST=* 


OC=* 


PLM=* 


BS=ALL 


OUTDV=W 


OUTDV=T001 
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{display status of all disks from MSA1 to MSB2} 
{display status of all magnetic tape drives} 
{display all stations information} 


{display characteristics and activities for all output 
classes} 


{display all pre-initialized load modules} 
{display status of backing stores} 


{display the characteristics and the output activities of 
all magnetic writers (W001, W002, ..)} 


{display the output activities of the GTP T001} 


OUTCLASS=A OUTDV=* 


{display the configuration of outclass A (priority, 
output media, size), and the characteristics and output 
activities of all writers} 


VOLUME=VOL1 :MS/FSA 


NOTES: 


1. 


{display status of FSA disk VOL1} 


For more information about hardware resources, use the command 


DISPLAY HARDWARE CONFIGURATION (DHW). 


To display information about CPU priorities, dimensions or memory, use 


the DISPLAY _XL_CLASS or DISPLAY_DIMENSION commands. 


For more information about transfers (OQUTDV=T[nnn)]), use the command 


DISPLAY _DJP (DDJP). 


7-67 


GCOS 7 System Operator's Guide 


7.6.13 DISPLAY_CONSOLE_LOG (DCLOG) 


Purpose 


Scans and displays selected portions of the SYS.LOGC file. 


Syntax 
{DISPLAY CONSOLE LOG} 
{DCLOG } 
[ {BEG }] 
[ {END }] 
[ {ISL }] 
[ {<stringl5 }] 
[ {>stringl15 } 
[OPTION = {< } 
[ {> } 
[ { [mm.dd. [yylyy/] hh.mm} 
[ {G>string15 } 
[ {G<string15 } 
[ {x } 
[ {IDM } 
[SIZE = {dec2|18}] 
[PATH = dec4] 
[SKIP = dec4] 
Parameters 
OPTION How the file is to be scanned. Applicable values are: 


— BEG: display the first page of the file. 


— END: display the last page of the file (also reset the 
values of PATH, SIZE and of the "current string"). 


— ISL: position to previous ISL and display its page. 


— <string]5: move backwards till the given string is 
found. It may be used to refer to the "current string" 
as defined in a previous DCLOG command and 
display corresponding page (also memorize value of 
string15 as "current string"). 
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— >string15: move forward till the given string is 
found. It may be used to refer to the "current string" 
as defined in a previous DCLOG command and 
display corresponding page (also memorize value of 
string15 as "current string"). 


— <: move backwards and display the corresponding 
page. 


— >: move forwards and display the corresponding 
page. 


— [mm.dd.[yy]yy/]. hh.mm: locate the entry that 
corresponds to the given date or as close as possible 
to that date and display the corresponding page. 


— G>string]5: move forward and display all lines 
containing string15. 


— G<string]15: move backward and display all lines 
containing string15. 


— X: display the date of the current line being 
displayed, the value of PATH and the "current 
string”. 


— IDM: display the current page again. When omitted, 
> is assumed. 


SIZE Display page size. Default is 18. Possible values are 3 
to 18. 
PATH Scanning is limited to current day or to value specified 


by PATH. When a search has failed, the next search is 
not limited by PATH or by the date. 


SKIP Number of SYS.LOGC entries skipped before starting 
to scan. 


Rules 
The DCLOG command is only available in Interactive Mode. 


When the year is expressed with the digits in the OPTION expression, it must 
verify the interval: 


1961 =< yyyy =< 2060 
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Examples 
DCLOG ISL {move to the preceding ISL} 


DCLOG '>JOB START' {locate the string 'JOB START"} 


DCLOG {move forwards and display the corresponding page} 

DCLOG 'G>X123 AB' {display occurrences of string 'X123 AB' from this 
point} 

DCLOG <ABORTED {look backwards for string ABORTED} 

DCLOG G>X123 {display all lines that contain X123 from this point} 


DCLOG 12.31.2041/18.08 
{locate the entry that corresponds to the December 31, 
2041, from 6:08p.m.; and display the corresponding 


page} 
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7.6.14 DISPLAY_DEVIATION_TIME (DDTIME) 
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Purpose 


Displays the time deviation of GCOS 7 and the time deviation of the Service 
Processor. Time deviation is the difference between GMT and the local time. Its 
value is positive when local time leads (is later or greater than) GMT, and negative 
when local time lags GMT. If Service Processor support is not available, only the 
GCOS 7 time deviation is displayed. In the case of an Input/Output failure, the time 
deviation is reported as UNKNOWN. 


Syntax 


{ DISPLAY DEVIATION TIME } 
{ DDTIME 


Parameter 


None. 


Rules 


None. 


Example 


DDTIME (Display the GCOS 7 and the SP time deviations) 
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7.6.15 DISPLAY_DEVICE_TRACE (DDVTR) 


Purpose 


Displays information on events logged for a device, a range of devices or devices 
of a certain class. The displayed information shows for each selected device: 


e the current number of I/Os, 
e the number of logged events, 


e the threshold value (see the MODIFY DEVICE TRACE command). 


Syntax 
{ DISPLAY DEVICE TRACE } 
{ DDVTR } 
‘oe 
[ { DEvIcE } { dvtyp } ] 
fea pe ee 
[ { Dv } { dvnm } ] 
ss } {ave } ] 
[ VOLNAME = nameé ] 
Parameters 
DEVICE the device(s) for which information is to be displayed, 
expressed as: 
*: all devices, 
dvnm: a specified device, 
dvtyp: all devices of a type 
dvc: all devices of a class. 
When omitted, all devices (*) is assumed. 
VOLNAME information displayed is restricted to the named 
volume. 
Rules 


VOLNAME may be used only when DEVICE is dvnm. 
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Examples 


DDVTR 


DDVTR 


DDVTR 


DDVTR 


DDVTR 


NOTE: 


* 


MS 
MS/B10 


MS03 


MSO3 DISK5 
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{display information for all devices} 

{display information for all disk units} 

{display information for all MS/B10 disk units} 
{display information for disk unit MS03} 


{display information for volume DISKS5 on disk unit 
MS03} 


For more information on this command, see Section 6.6, Monitoring Device 
Incidents, and the ELO2 message in the Console Messages Directory. 
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7.6.16 DISPLAY_DIMENSION (DDIM) - BASIC ARM 


Purpose 


Displays statistical information about dimension(s) on systems with ARM BASIC 
level. See the ARM User's Guide for full details. 


Syntax 
{ DISPLAY DIMENSION } 
{ DDIM } 
[ { names } ] 
DIM = [ { ] 
Lite ] 
[ { MPL} ] 
[ OPTION = { }] 
[ { Xnnnn } ] 
[ { SYSTEM } ] 
[ { } = name4 ] 
[ { sys } ] 
Parameters 
DIM name of the dimension. If DIM=* or ALL, the 
command applies to all dimensions. 
OPTION the type of information required: 


OPTION= MPL displays the following: 


DIMNAME MPL ALLOC USED(MB) FIX(MB) OUT/S FLT/S 


the MPL, as set by the MDDIM command 

the current number of steps in execution 

the used size (USED) in megabytes; does not 
include dedicated I/O cache size 

the fixed size (FIX) in megabytes; does not include 
dedicated I/O cache size 

the page out frequency (OUT/S) 

and the page fault frequency (FLT/S). 


OPTION= Xnnnn: see the Xnnnn option of the Full 
ARM command (below) 
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SYSTEM This parameter indicates the system where the 
command will be executed. 


Rules 


User must be in a MAIN operator project. 


Examples 
DDIM * {Display information for each of the dimensions} 
DDIM IOF {Display information on the IOF dimension} 
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7.6.17 DISPLAY_DIMENSION (DDIM) - FULL ARM 


Purpose 


Displays statistical information about dimension(s) and job activities on systems 
with ARM FULL. For full information, see the ARM User's Guide. 


Syntax 

{ DISPLAY DIMENSION } 

{ DDDIM } 
[ DIM = { name-8 } ] 
[ y @ AR 
[ { ATTR }] 
[ { CN ted 
[ { MPL had 
[ { PERF ] 
[ OPTION = { RSC ha] 
[ { CPU ] 
[ { RON }] 
[ { Xnnn heal 
[ { * }] 
[{SYSTEM  } ] 
[{ } = name-4 ] 


[{sys } ] 
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Parameters 


DIM 


OPTION 


CPU 
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name of the dimension. If * or ALL is specified, the 
command applies to all dimensions. 


the type of information required: 
If * is specified, the command applies to all options. 


For more information about the ATTR, CN, MPL, 
PERF and RSC parameter values, see the ARM User's 
Guide. 


displays the following information for STANDARD, 
CDP1, CDP2 and CDP3 job categories: 


JOBTYPE ASR(%) CPU(%) PWM(%) 
STANDARD 22.5 250.2 400.0 
CDP1 7.4 167.1 600.0 
CDP2 43.1 325k 800.0 
CDP3 27.4 15.1 500.0 


if there is no EPU, FPU or GPU processor, CPU 
displays the following for STANDARD job categories: 


JOBTYPE ASR(%) CPU(%) PWM(%) 
STANDARD 22.5 250.2 400.0 


— STANDARD jobs are jobs which run only on 
standard processors (IPUs). 

— CDPI1 entitled jobs are jobs which run on EPU 
processors (Extended Processor Units), and also on 
standard processors (IPUs) if needed. 

— CDP2 entitled jobs are jobs which run on FPU 
processors (Extended Processor Units type 2), and 
also on standard processors (IPUs) if needed.. 

— CDP3 entitled jobs are jobs which run on GPU 
processors (Extended Processor Units type 3), and 
also on standard processors (IPUs) if needed. 


— The Absolute Service Rate (ASR) is the percentage 
of resource consumption of all jobs in the category 
concerned relative to the maximum capacity of the 
system. 
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— The CPU consumption of all jobs in the category 
concermed, relative to the maximum CPU power of 
the system (including both IPUs and EPUs, FPUs or 
GPUs). This value is not divided by the number of 
CPUs and therefore can exceed 100. The value is 
averaged over a relatively long period (presently 50 
seconds). 


— The maximum CPU power (PWM), including both 
IPUs and EPUs, FPUs or GPUs that the jobs in the 
category can use. This value is not divided by the 
number of CPUs. 


This option can be used to ascertain the system load 
for each job category, for example, to check whether 
more standard jobs can be started. 


RON Run Occurrence Number 


Xmnnn na 


SYSTEM The system where the command is executed. 


Rules 

e Options ATTR, CN, PERF, RON, RSC, and CPU are available in FULL level 
only. 

e When Option = Xnnnn, CPU and DIM must be *. 


e Instantaneous information about Rons is displayed as it is collected; the total 
amount of ASR and CPU for all the dimensions can be more than 100. ASR, 
CPU and I/O concern the last regulation period; XL is the current one. 


Examples 

1. This command displays information about the execution requests for each of 
the dimensions. 
DDIM DIM=* OPTION=MPL 

2. This command displays ATTR, CN, MPL, PERF, RSC, CPU, and RON for all 
the existing dimensions and jobs. 


DDIM DIM=* OPTION=* 
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3. This command displays information about system CPU consumption for 
standard and other domain if the corresponding CPU resource is present. 


DDIM DIM=* OPTION=CPU 


If there are no EPUs, FPUs or GPUs processors, the information displayed is 
similar to the following (the STANDARD line corresponds to the IPUs 


processors): 
JOBTYPE ASR (%) CPU (3) PWM (%} 
STANDARD 1122 50.0 100.0 


If there are EPUs, FPUs or GPUs processor, the information displayed is 
similar to the following example (for 4 IPUs + 2 EPUs + 4 FPUs + 1 GPU 


processors): 

JOBTYPE ASR (%) CPU (3) PWM (%} 

STANDARD 22.5 250.2 400.0 (IPUs) 

CDP1 7.4 167.1 600.0 (IPUs + EPUs) 
CDP2 43.1 327.1 800.0 (IPUs + FPUs) 
CDP3 27.4 15.1 500.0 (IPUs + GPUs) 


The whole CPU power is 400 (IPUs) + 200 (EPUs) + 400 (FPUs) + 100 (GPUs) = 
1100. 


The table below, that refers to the example above, lists the CPU power used and the 
fraction of the whole CPU power that can be used by each type of job. 


Job Type CPU Power Used Fraction of Whole CPU 
Power That Can Be Used 


Standard jobs 250/400 400/1100 
CDP!1 entitled jobs 167.1/600 600/1100 


CDP2 entitled jobs 327.1/800 800/1100 


CDP3 entitled jobs 15.1/500 500/1100 
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7.6.18 DISPLAY _DJP (DDJP) 


Purpose 


Displays information on the Distributed Job Processing (DJP) activity of the 
system. 


Syntax 


{ DISPLAY DJP } 
{ DDJP } 


ALL 
QUEUE 
HOLD 

EX 
WIFL 
WDTM 
WIFR 
WAIT 
TFR 
Tddd 


Cal 


OPTION = 


Fontes Tanto Canton Tanten tanten Canton Canton ‘antes tonten onten’ 
Re eee ee 
wo 


ALL 


ip) 
H 
HA 
ie5 
Il 


{ } 
{ ed 
{ sitenm } 


coal 


YEAR = dec4 ] 


al 


JOBNAME = bool ] 


Coal 


DETAILED = bool ] 


coal 


UFTWAIT = bool ] 
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Parameter 


OPTION 


SITE 


YEAR 


JOBNAME 


DETAILED 


UFTWAIT 
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The information to be displayed, as follows: 


ALL all known requests with their characteristics, 
QUEUE requests that are in a queue, 

HOLD requests being held, 

EX requests being processed, 

WTEFEL requests waiting for file availability, 

WDTM requests waiting for date and time condition, 
WTER requests waiting for finish of another transfer 
request, 

WAIT requests that are waiting and eligible to be 
processed, 

TFR the current status of the system processors in 
charge of transfer activities (files, jobsets and outputs), 
Tnnn status of processor in charge of transfer whose 
identification is Tnnn. 


The default value is ALL, except when SITE is 
specified, in which case, TFR is taken as the default 
value. 


Restricts the display to the requests that are addressed 
to the named site (QUEUE, HOLD, EX, WTFL, 
WDTM, WTER, WAIT) or to the processors which are 
dedicated to this site (TFR). 


Displays all the days of the week not worked, plus all 
the holidays for the specified year. There are default 
lists for non-working days that can be modified using 
the MODIFY _DJP command. 


When set to 1, this parameter gives either the subfile 
name or the file name. It is useful to locate specific 
requests among all requests, when there are a large 
number of requests. It must be used with the OPTION 
= ALL. 


When this parameter is set to 1, the command displays 
the public holidays in detailed mode for the year 
specified in the YEAR parameter. 


When this parameter is set to 1, the command displays 
the waiting time, in hours and/or minutes, between two 
data transfers. 
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Rules 

SITE is ignored when OPTION is Tnnn. 

YEAR and SITE are incompatible. 

YEAR and OPTION are incompatible. 

UFTWAIT and (OPTION, SITE, YEAR, JOBNAME) are mutually exclusive. 


Examples 

DDJP (Display all DJP requests.) 

DDJP QUEUE HST1 (Requests in the queue for site HST1.) 

DDJP WDTM (Requests waiting for date and time condition.) 

DDJP TFR (Status of all transfer processors.) 

DDJP T3 (Status of transfer processor T3.) 

DDJP TFR HST2 (Status of transfer processors dedicated to site HST2.) 
DDJP SITE=HST2 (same as above) 


DDJP ALL JOBNAME = 1 
(Displays the subfile or the file name for all the DJP 
job requests. ) 


Command (1) displays the information (2): 
DDJP UFTWAIT (1) 
UFT WAITING TIME : 20 minutes (2) 
Command (1) displays the information (2): 
DDJP YEAR=2000 DETAILED (1) 


NOT WORKING DAYS FOR:BCO6 ARE: SATURDAY, SUNDAY 
FOR 2000,HOLIDAYS ARE: 


} 

} 

JULIAN DAY NUMBER JULIAN DAY } 
1 JAN 1 aes 

3 JAN 3 } 

36 FEB 5 } 

252 SEP 8 } 
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7.6.19 DISPLAY_DUMP (DDP) 


Purpose 


Displays information concerning the specified dump, or the percentage of free 
space and the number of dumps in SYS.SPDUMP. For further information, refer to 
Appendix B Index of Commands by "Object". 


Syntax 

{ DISPLAY DUMP } 

{ } 
} 


{ DDP 
[ DUMP_ID = charl14 ] 


[ SPACE = bool ] 


Parameters 


DUMP_ID the dump identification as displayed by the LSDP 
command. 


The following message is displayed if the dump exists: 


DPO2 <dumpid> PGID=<jjjj> <lmname> <date> 
TERM MSG=xXxxxxxxx 


is the name of the load module (first 16 characters 
only); "date" is the date and time of dump creation; 
and "xxxxxxxx" is the termination message of the step. 


SPACE if 1, the percentage of free space and the number of 
dumps in SYS.SPDUMP are displayed in the 
following message format: 


DP03 nn% OF SYS.SPDUMP SPACE FREE 
NBDUMP=dec4 


47 A2 53US 7-83 


GCOS 7 System Operator's Guide 


Constraints 


DUMP _ID and SPACE are mutually exclusive. 


Examples 
DDP X2345 11 {display information on the dump X2345_1 1} 
DDP SPACE {display percentage of free space and number of 


dumps in SYS.SPDUMP} 
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7.6.20 DISPLAY_DYNSAVE_SVR (DDYNSVR) 
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Purpose 
This command displays information on the current state of the dynamic saves in 


progress. 


Syntax 


{ DISPLAY DYNSAVE_SVR } 
{ DDYNSVR } 
Parameters 


None. 


Rules 
This function is only available when the server is active. 


If the server is inactive, the following message is displayed: "PLEASE RETRY 
LATER (TERMINATE RUNNING OR NO SERVER)". 


Example 

DDYNSVR (Produces the display shown below:) 

BYA2: ddynsvr 
PLU SERVER OF DYNAMIC SAVE : X2762 

BYA2: ddynsvr 
PLUG SERVER OF DYNAMIC SAVE : X1616 
PLUG SAVE XRON : X1815 
PLUG NUMBER OF FILES TO SAVE : 3 
PLUG REMAINING FILES TO SAVE : 3 
PLUG WORKFILE BLOCK-4K USED : 10 


SAVE IN SAVE PHASE 
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7.6.21. DISPLAY_ERROR_LOG (DERLOG) 


Purpose 


Displays information held in the SYS.ERLOG system file. The information to be 
displayed can be selected according to the type of events that are being analyzed. 


Syntax 


{DISPLAY ERROR_LOG} 
{DERLOG } 


[ { 
[ { 
[OPTION = { 
{ 
{ 


[ 
[ 
[ 
[ 
[SELECT 
[ 
[ 
[ 
[ 


Il 
[stun auten tanten anton anton tanten tonten tanten tanten’ 


[{DEVICE} ] 
[{ } = dvnn] 
[{DV } ] 


[ATN = bool 


] 
[WARN = bool] 
[ABN = bool] 
[KEY = chars] 
[{DISPLAY LENGTH} ] 
[{ } = dec1] 
[{DLG } ] 


[FROM = mm.dd. [yy] yy/hh.mm] 
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Parameters 


OPTION 


SELECT 


DEVICE 


ATN/WARN/ABN 


KEY 


DISPLAY LENGTH 
FROM 
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the action to be performed, as follows: 


STATE display the state of the SYS.ERLOG file. 
LAST display the last message again. 

SET specifies default values for DISPLAY LENGTH 
and FROM to apply to future operations. SET with no 
other options resets the search values 

(DISPLAY _LENGTH = 1 and FROM = current date). 
PRINT print messages, as selected by the other 
parameters. 


When omitted, PRINT is assumed. 
the type of messages searched for, as follows: 


CHEXC channel exceptions (device controller in stop) 
SYSDOWN system terminations and crashes 

SYSUP system loadings 

ITR Initialization Test Results 

SYSERR system errors 

SYSEXC system exceptions 

MISC miscellaneous, not any of the other cases 

OPR operator message written by SNDERLOG 


select messages relating to I/O events on the named 
device. 


further select the type of events on DEVICE (see 
command START DEVICE TRACE for an 
explanation) 


(with SELECT=OPR) selects the key (first characters) 
of the operator messages to be printed. 


the number of selected records to be displayed. 


the date and time from which to start search in reverse 
chronological order. 
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Rules 


e SELECT, DEVICE, KEY, DISPLAY LENGTH and FROM are ignored when 
not relevant for the value of OPTION. 


e When OPTION is PRINT, either SELECT or DEVICE must be used. 
e ATN, WARN and ABN are ignored if DEVICE is not specified. 
e KEY is significant with SELECT = OPR 


e When the year is expressed with the digits in the FROM expression, it must 
verify the interval: 1961 =< yyyy =< 2060. 


Examples 


DERLOG SET DLG=5 FROM=10.25.88/15.30 

DERLOG SET DLG=5 FROM=12.31.2041/20.10 

DERLOG PRINT CHEXC 

{5 records of type CHEXC are displayed (if any) starting from the indicated date} 


DERLOG OPR KEY = XXXX 
{operator messages written by SNDERLOG and beginning with XXXX are 
displayed} 


NOTE: 
For more details on the information returned by this command, see the EL01, 
ELO9, and EL10 messages in the Console Messages Directory. 
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7.6.22 DISPLAY_FUNCTION (DFUNC) 
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Purpose 


Display information about functions and domains. This information for a domain is 
the function name (if any), and the number of running Load Modules that are using 
the domain resources. 


Syntax 
{ DISPLAY FUNCTION } 
{ DFUNC } 
[ DOMAIN = { name-8}] 
[ at? 2 al 
[ { SYSTEM } ] 
[ { } = name-4 ] 
[ { sys } ] 
Parameters 
DOMAIN Name of the domain. If the default value "*" is 
specified, the command is applied to all domains. 
SYSTEM The system where the command will be executed. 
Rules 


The number of displayed domains is related to the hardware resource presence. 
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Examples 


DFUNC * 


DOMAIN 
STANDARD 
STANDARD 
CDP1 
CDP1 
CDP2 
CDP3 


On ARTEMIS2, configuration A: 


DFUNC * 


DOMAIN 
STANDARD 
STANDARD 
CDP1 
CDP1 
CDP2 
OPENP 


On ARTEMIS2, configuration B: 


DFUNC * 


DOMAIN 
STANDARD 
STANDARD 
CDP1 
CDP1 
CDP1 
CDP1 
OPENCDP 
OPENP 


NOTE: 


RUN JOBS 


84 


12 


23 


RUN JOBS 


25 
0 


5 
0 
2 
4 


RUN JOBS 


22 


WNHNROOEH 


{display information about all domains} 


FUNCTIONS 
SYSTEM 
DW7 
ORACLE 
OPEN7-F1 
OPEN7 

IQS 


{display information about all domains} 


FUNCTIONS 
SYSTEM 
DW7 
ORACLE 
IQS 

TDS WEB 
OPEN7 


{display information about all domains} 


FUNCTIONS 
SYSTEM 
IQS 
ORACLE 
DW7 
Y2KTEST 
TDS WEB 
OPEN7_F1 
OPEN7 


The CONNECT FUNCTION, DISCONNECT FUNCTION and 
DISPLAY FUNCTION commands are part of the MAIN GCL domain. 
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7.6.23 DISPLAY_GCL_CACHE (DGC) 


Purpose 


This command generates a display giving the following information for cache 
levels: 


Number of SYS.SPOOL1 files used, 

Names of pre-initialized domains from the SYS.HBINLIB file for GCL cache, 
Cache validation for GCL commands, 

Cache usage for GCL commands, 

Cache size used for GCL commands, 

Number of GCL commands found in cache. 


{ DISPLAY GCL CACHE } 
{ DGC } 
Parameters 


None. 


Example 


DGC 
-> VALID SPOOLS: 0, 1 
PREINITIALIZED DOMAINS: 


H_BREAK 
H_NOCTX 

IOF 
LIBMAINT SL 
MAIN 


CACHE FOR COMMANDS: 
VALIDATED AT ISL 
USED FOR ALL COMMANDS 


MAXIMUM SIZE IS 128K (2 segments) 
1295/1344 REFERENCED COMMANDS FOUND IN CACHE 
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7.6.24 DISPLAY_HARDWARE_CONFIGURATION (DHW) 


Purpose 


This command requests a display of the state of hardware units on the operator 
console. 


Syntax 


{ DISPLAY HARDWARE CONFIGURATION } 
{ DHW } 


* 


[ { 

[ { hardware unit 

[ UNIT = { hardware unit type 
[ { device class 

[ { device path 


We We we 
a ee ee 


[ { css } ] 
[ SELECT = { CTL } ] 
[ { DEVICE Dv } ] 
[ PATH = { bool }] 
Parameters 
UNIT Specifies the resources whose states are to be 


displayed. The following values are possible: 


— * represents units specified in the SELECT 
parameter. 


— A hardware unit (4 characters) which can be: 


a CSS resource (IPnm, EPnm, FPnm, GPnm, JOnm, 
MUhh, PXnm) 

a controller (xCnm) 

a peripheral device (dvnm). 


— The hardware-unit-type parameter (2 characters) 
represents a resource family (MU, MS, IP, EP, FP, 
GP, etc.). 


— The device-class representing all devices that have 
the given characteristics (MS/B10, MT/T9, TC/M3, 
MC/MS5, UC/MS3, etc.). 
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You can specify all characteristics or only some of 


them: 

CT/36T: all class 36T cartridge tape devices not in a 
library 

CT/LIB: all cartridge tape devices in the library 

Cn/C all devices with the compaction capability, 


whether in a library or not. 
— The device-path (9 characters) representing a path to 
a peripheral device (xCnm.dvnm). 


SELECT This parameter is used with the UNIT=* parameter to 
specify units whose states are to be displayed. Three 
options are possible: 


— The CSS keyword specifies all CSS units. 

— The CTL keyword specifies all controllers. 

— The DEVICE or DV keyword specifies all 
peripheral devices. 


PATH The boolean value parameter | can be used to display 
the status of all path to or from the unit specified in the 
DHW command. A path is limited to two consecutive 
resources in the configuration hierarchy. 


When an IOP name is specified, a display line appears 
for each path from the IOP with the following 
information: path status, PC number, and external 
name of the associated controller (xCnm). 


When a controller is specified, the first display line 
indicates the external name (xCnm), the channel 
number and the status of the controller. This is 
followed by one display line per device linked to the 
controller giving the external name of the associated 
path (xCnm.dvnm), the channel number (pclc), and 
path status. 


When a device is specified, one display line appears 
for each path leading to the device; each display line 
indicates the external name of the path (xCnm.dvnm), 
the channel number (pclc), and the path status. 
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Rules 


e When the SELECT=CTL option is specified, display lines appear only for disk 
controllers (MC) and unit record controllers (UC). 


e When the SELECT=DV option is specified, a display line appears indicating the 
status of all the peripheral devices and their controllers in the configuration. 


e The commands DHW MU, DHW MUxx, or DHW * CSS do not distinguish 
between the different memory units. Consequently, the dedicated I/O cache 
memory unit (if any) is not distinguishable from other memory units. If, 
however, a dedicated I/O cache is not initialized, it is displayed as "NOT 
ACCESSIBLE"(see Examples). 


Examples 


DHW * SELECT=CSS {Display the state of all Central Subsystem Units. } 


DHW IP {Display the state of all Instruction Processor Units. } 

DHW EP {Display the state of all Extension Processor Units 
type 1.} 

DHW FP {Display the state of all Extension Processor Units 
type 2. 

DHW GP {Display the state of all Extension Processor Units 
type 3.} 

DHW MS/FSA {Display the states of all the FSA disks. } 

DHW MSO1 PATH {Display all the paths leading to MSO1.} 

DHW 1001 PATH {Display all the paths that start from IOP 01.} 

DHW IPO5 {Display the state of the IPU 05} 

DHW MU {Displays the state of all memory units, as follows: 


08.38 MUO3 IN 
08.38 MUO2 IN 
08.38 MUO1 OUT (NOT ACCESSIBLE) 
08.38 MUOO IN 


MU01 is a dedicated I/O cache memory unit which has 
not been initialized. } 
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Biprocessor in bi-system (on the S1 system) 


S: DHW IP 


IPO1 OUT (NOT ACCESSIBLE) 
IP51 IN 


Display all paths starting from IOP 06 


S: DHW I006 PATH 


Io006 IN 
PX60 IN 
TCO2 C200 IN 
CCc11 C300 IN 
PX61 IN 
MCC4 C400 IN 
PxX62 IN 
UC20 CBOO IN 
MCCA CAOO IN 
MCC8 C800 IN 


Multiprocessor running a mono-system 


S: DHW * SELECT = CSS 


MU07 OUT (NOT ACCESSIBLE 
MU06 OUT (NOT ACCESSIBLE 
MU0O5 OUT (NOT ACCESSIBLE 
MU04 IN 
UT (NOT ACCESSIBLE 
UT (NOT ACCESSIBLE 
NOT ACCESSIBLE 


é 
oO 
pa 
g 
c 
t 
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(NOT INSTALLED) 
PX30 OUT (NOT INSTALLED) 
(NOT INSTALLED) 
(NOT INSTALLED) 


Display of all the paths leading to MS01 


S: DHW MSO1 PATH 


MCO1.MS01 0001 IN (READY) 
MCO2.MS01 0401 OUT (BY OPERATOR) 
MC21.MS01 2001 IN (SPARE) 
MC23.MS01 2601 IN (READY) 


Display of all FPU CPU 


S: DHW FP 


FP04 OUT (BY OPERATOR) 
FPO5 IN 


7-96 47 A2 53US 


Description of the Operator Commands (Part 1) 


7.6.25 DISPLAY_lO CACHE (DIOC) 
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Purpose 


This command displays current information and statistics on the I/O Cache 
function. See the Large Memory Cache User's Guide for full details. 


Syntax 


{DISPLAY IO CACHE} 
{DIOC } 


Parameters 


None. 


Rules 


None. 
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Example 


S: DIOC 
BEGINNING DATE: 91/03/11 14.57 
CURRENT DATE : 91/03/11 1569 
INITIAL SIZE : 8 [MB] 
CURRENT SIZE : 8 [MB] 


STATUS : ACTIVE 
MODE : CACHE 
DEFAULT : FORCE 
GLOBAL STATISTICS SINCE 91/03/11 14.57: 
NB_IOS : NB READS : NB WRITES : NB HITS : %HITS 
30717: 15596: 10773: 0: 35 


CURRENT ACTIVITY (LAST 5 PERIODS) 
PERIOD DURATION: 120 [SEC] 


MIN SWI : 0 
MAX SWI : 0 
NB IOS  : NB READS : NB WRITES : NB HITS : $%HITS 
1 1659 875 660 0) 39 
2 6171 3294 2304 0) 37 
3 6425 3146 2139 0 33 
4 6954 3270 2031 ) 29 
5 5325 2844 2053 0) 38 
26534 13429 9187 0 34 
Key to the headings: 
NB_IOS: Total number of I/O requests diverted to the cache. 
NB_READS Number of read requests. 
NB_HITS Number of physical reads that have been gained. 
NB_WRITES Number of physical writes which have been gained. 
%HITS The hit ratio, calculated as follows: 


((NB_HITS - nb. of read-aheads)/NB_ IOS) x 100 


MIN %WI Minimum occupancy of the WRITE-INTO images in 
the Cache during the last five periods. % is relative to 
the whole cache size. 


MAX %WI Maximum occupancy of the WRITE-INTO images in 
the Cache during the last five periods. % is relative to 
the whole cache size. 
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7.6.26 DISPLAY_IOF (DIOF) 
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Purpose 


Displays certain IOF param 


Syntax 


{ DISPLAY _IOF } 
{ DIOF } 


Lee lee Bie lee 
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eters and statistics. 


[ { name12 } ] 


[ DETAILS = { 


}] 


[ { Xnnnn } ] 


RECN TIME 


= 
aa eos 


RT 
IDLE TIME 


IDT 


— 
aaa 


Parameters 


USER 


DETAILS 


RECN_TIME 


IDLE_TIME 


= bool ] 


= bool ] 


The identification of an IOF user for whom global 
information is to be displayed. This may be expressed 
as the user name, the Run Occurrence Number 
(Xnnnn) of a session, or ALL (or *) if all users are 
intended. 


The identification of an IOF user for whom detailed 
information is to be displayed. This may be expressed 
as the user name or as the Run Occurrence Number 
(Xnnnn) of an IOF session. 


If 1, the maximum reconnection time is displayed (i.e. 
the lapse of time after which reconnection of an 
accidentally disconnected user is not allowed). 


If 1, the maximum idle time is displayed (i.e. the lapse 
of time after which idle IOF users are disconnected). 
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Rules 

None. 

Examples 

DIOF {display global information} 

DIOF USER=X1234 {display global information for session X1234} 
DIOF * {display global information for all sessions} 


DIOF DETAILS=JONES {display detailed information for user Jones} 


DIOF RT {display maximum reconnection time} 
DIOF IDT {display maximum idle time} 
NOTE: 


Information displayed is as follows: 


S: DIOF 


hh.mm DGI LOGON=n1 PUT=n2 SEND=n3 GET=n4 RECV=n5 
SCD=n6é SSW=n7 


where: 


e nl =number of logon 

e n2=number of logical outputs on IOF terminals 
e n3 =number of physical outputs on IOF terminals 
e n4=number of logical inputs on IOF terminals 

e n5 =number of physical inputs on IOF terminals 
e n6=number of system commands 

e n7=number of steps switches 


For DIOF USER=... (user global information) : 
usernm [lm-name] 
where: 


e usernm = user name 
e Im-name = name of the program currently being executed. 


S: DIOF USER=X1265 


47 A2 53US 


Description of the Operator Commands (Part 1) 


7.6.27. DISPLAY_JAS (DJAS) 


Purpose 


This command displays the jobs that are currently connected to the JAS 
(Journalization Advanced Service). It gives the following information for the jobs 
of the designated JAS: 


e Run Occurrence Number, 

e Job Name, 

e User Name (submitter), 

e Job Class, 

e Load Module being executed. 


DJAS is particularly useful before executing a TAKEOVER_ MEMBER command 
with the WEAK option. It displays the TDS, Batch and IOF applications to be 
stopped. 


Syntax 


{ DISPLAY JAS } 
{ DJAS } 


[ JAS NAME = { GREEN | BLUE | SyS } ] 


Parameters 

JAS_NAME Journalization Advanced Service name. It may be 
GREEN, BLUE or SYS. The default is all. 

Rules 

None. 
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Example 
DJAS JAS NAME=BLUE Displays all jobs connected to BLUE JAS, as follows: 


hh.mm JAS:BLUE X151.1 TP7JCLAC OPERATOR P TDS1 
X168.2 BAT2 USER2 P H_ BAT2 


where: 


P is the Job Class 

BAT2 is a batch job using BLUE JAS. 
TDS1 is a HA-type TDS using BLUE JAS. 
H_BAT2 is the Load Module. 
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7.6.28 


DISPLAY_JOB (DJ) 


Purpose 
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Displays the current status of selected jobs. 


Syntax 
{DISPLAY JOB} 
{DJ } 
{jstate }] 
{jtype }] 
JOBID = { (jstate jtype) }] 
{Xnnnn }] 
{names }] 
{SELECT} {jclass}[ {usernm}[  {projnm}]]] 
[ 7 Beaty PLA }1]] 
{SEL }  {* [  {* }L o{* }1]] 
{STATION} {* ] 
{ } = fan} 
{ST } {names }] 
JOBNAME = name8] 
{200 }] 
LAMET = {20% }] (See parameter description 
{dec4}] for default value) 
[{SYSTEM} ] 
{ } = name4] 
{sys } ] 
{ SEQUENCE {PRIORITY |DECR_ITIME|INCR_ITIME}] 
{ = { | | }] 
{SEQ { | DIT | IIT }] 
{DETAILED ] 
{ = {bool |0}] 
{DTLD ] 
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Parameters 


JOBID 


SELECT 


STATION 


JOBNAME 
LIMIT 


SYSTEM 


SEQUENCE 
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the jobs to be displayed designated by their Run 
Occurrence Number (Xnnnn), name (name§8), current 
state (jstate), job type (jtype), or current state and job 
type. 


jstate must be one of the following: 
ALL, SCH, EX, SUSP, OUT, IDLE, IN, HOLD 


jtype must be one of the following: 
ALL, BATCH, IOF, SERVICE, NSERVICE 


If NSERVICE is specified, all jobs except the service 
jobs are displayed. 


When JOBID is unspecified, ALL is assumed. 


restricts the directive to the jobs that belong to the 
specified combination of class/user-name/project. * is 
all jobs. When omitted, all jobs for which USER is the 
terminal user are assumed. 


restricts the list of jobs displayed to those that are 
attached to the named station (* or ALL for any 
station). When omitted, the current working station of 
the submitter is assumed. 


the job or jobs to be displayed by name (name-8). 


maximum number of jobs to be displayed. Beyond that 
limit, only the number of jobs per class is displayed. 
The default and maximum values are: 

When DETAILED=1, default 20, maximum 100 
When DETAILED=0, default 200, maximum 850. 


indicates the system where the command is to be 
executed. 


specifies the order in which jobs are to be displayed 
for each job state. The sort criterion can be the 
scheduling priority (keyword PRIORITY) or the 
introduction time (keywords DECR_ITIME and 
INCR_ITIME). The display order for each job state is 
determined by: 


— the scheduling priority (PRIORITY), from highest 
to lowest. The introduction time is used for second 
level sorting within each priority level. This is the 
default display criterion. 
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DETAILED 


HOLD 


EX/ SUSP 


OUT 


IN, SCH, IDLE 


Rules 
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— or the introduction time alone, (PRIORITY not 
specified): 
DECR_ITIME = from most recent to oldest 
INCR_ITIME = from oldest to most recent. 


(abbreviation DTLD) specifies whether detailed job 
information is to be displayed. The information 
returned depends on the job state: 


Hold count 
Introduction time 


Introduction time 

Switches 

Full load module name or step state 

System internal identifier associated with the step 
CPU and elapsed times for the current step 
Number of processes 

Backing store 

Used and fixed instantaneous memory sets. 


It is not always possible to provide all of the above 
information for jobs in state EX or SUSP, in particular 
the ARM dimension (e.g. IOF, BATCH) and the step- 
specific information (load module name, step CPU and 
elapsed time, number of processes, backing store, 
memory sets). This is the case at step initialization (if 
the step is waiting for a resource statically assigned by 
a JCL statement or for resources in a dimension), and 
at step termination. 


The introduction and termination times. 

These times may be unknown if the job is in the OUT 
state, and if they were kept after SYS.OUT recovery at 
system RESTART. 


The introduction time. 


When DETAILED=1, LIMIT may not exceed 100 and 
the default value is 20. 


When JOBID is in the form Xnnnn, SELECT and STATION and LIMIT are 


ignored. 


JOBID and JOBNAME are mutually exclusive. 
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Examples 


S:DJ 


EX 


SCH 


X222 


EX* 


ALL */JONES 


EX */*/PROJ 


PAYROLL 


BATCH C 


EX ST=ST1 


(EX NSERVICE) 


{Display the status of all jobs for which USER is the 
command submitter and that are attached to his current 
working station. } 


{Display the status of all executing jobs for which 
USER is the command submitter and that are attached 
to his current working station.} 


{Display the status of all scheduled jobs for which 
USER is the command submitter and that are attached 
to his current working station.} 


{Display the status of the job with RON X2272.} 


{Display the status of all executing jobs that are 
attached to the current working station of the 
command submitter. } 


{Display the status of all jobs for which the USER is 
JONES and that are attached to the current working 
station of the command submitter. } 


{Display the status of all executing jobs submitted 
under project PROJ.} 


{Display the status of all jobs named PAYROLL for 
which USER is the command submitter and that are 
attached to his current working station. } 


{Display the status of all batch jobs in class C attached 
to the current working station of the command 
submitter. 


{Display the status of all executing jobs for which 
USER is the command submitter and that are attached 
to station ST1.} 


*k 

{Display the status of all executing jobs that are not 
service jobs and that are attached to the current 
working station of the command submitter. } 


SEQUENCE=INCR_ITIME DTLD 


{Display detailed information about jobs for which 
USER is the command submitter and that are attached 
to his current workstation. Within each state, display 
the oldest jobs first. } 
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7.6.29 DISPLAY_LOAD (DLD) 


Purpose 


Display selected information on the current system load. 


Syntax 
{ DISPLAY LOAD } 
{ DLD } 
{BRIEF 1 
{LOAD } J 
{CLASS [[SELECT=]{* | jclass | jclass-jclass}] } ] 
{CLDTLD|CD [[SELECT=]{* | jclass | jclass-jclass}] } ] 
OPTION={CONNECT|CN [[SELECT=]{* | jclass | jclass-jclass}] } ] 
{ALLOUT [[SELECT=] {* | ALL | station} }}] 
{OUTPUT [[SELECT=]SPACE | {* | ALL | station} ] } ] 
{MEM [ [SELECT=] ron 1} ] 
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Parameters 


OPTION SELECT _ [Information displayed 


BRIEF Brief information on the job load |DLD 
DLD BRIEF * 
LOAD rd Job load by classes DLD LOAD 


aa[-aa] Current load of the specified class |DLD CLASS X 
= or range of classes (all classes if * |DLD CLASS AA-ZZ 
i or no class specified) 


Detailed information on specified 

classes if * or no class specified) 

Current connection or specified DLD CONNECT X 
class or range of classes (all classes |DLD CN AA-ZZ 


if * or no class specified) DLD CONNECT * 
DLD CONNECT 


All jobs with outputs in READY, |DLD ALLOUT 
WAIT, HOLD or OUT states of the |DLD ALLOUT STO1 
named station (all if ALL or *) DLD ALLOUT * 


The number of outputs in the DLD OUTPUT 
queues of the named station (all if |DLD OUTPUT ALL 
ALL or *) DLD OUTPUT * 


The percentage of free space in the |DLD OUTPUT 
SYS.OUT file SPACE 
Memory used by job Xnnnn DLD MEM X2222 


(-) means that SELECT is not allowed. 


Example 


DLD CD P 
{display detailed information about the job class P} 
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7.6.30 DISPLAY_MEMBER (DMB) 
Purpose 
Displays the States and Services of a MEMBER. This command is a part of the 
High Availability product (HA). For more information, see the High Availability 
Administrator's Guide. 
Syntax 
{ DISPLAY MEMBER } 
{ DMB } 
{ MEMBER } 
{ } = name4 
{ MB } 
[ STATE = { 0 | bool } ] 
[ { SERVICES } ] 
[ { } = { 0 | bool } J 
[ { SRV } ] 
Parameters 
MEMBER Name of the MEMBER to be displayed. 
STATE If entered, only the state of the MEMBER is displayed. 
SERVICES When this parameter is entered, the list of the 
SERVICEs implemented and running on this 
MEMBER, their type and their state is displayed. 
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Rules 
The CMSR of the MEMBER on which this command is entered must be running. 
The MEMBER must be in the COMPLEX description. 


Example 


DMB MB=MB1 Displays all information about the MEMBER named 
MBI. 


DMB MB=MB1 STATE Displays only information about the current status of 
the MEMBER named MB1. 


DMB MB=MB1 SRV __ Displays only information about the SERVICEs 
implemented on the MEMBER named MB1. 
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7.6.31 DISPLAY_MFT_FACILITIES (DMFTF) 
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Purpose 


Displays the status of the MFT facility (active or not active) and (to SYSADMIN 
only) indicates if the SITE.MFT file does not exist on your system. For status 
messages that can be generated, see "Command Output" below. 


Syntax 


{ DISPLAY MFT FACILITIES } 
{ DMFTF } 


[ OUTAREA = name31 ] 


Parameters 


OUTAREA Name of the existing GCL global variable that is to 
receive the result of this command (the message 
number only). The global variable must be declared 
with: 


TYPE = CHAR 

LENGTH = 6 (at least) for a user in SYSADMIN 
project 

LENGTH = 2 (at least) for a user in any other project 


Command Output 


O01 CAT MFT SUPPORT FACILITY IS NOT ACTIVE 

02 CAT MFT SUPPORT FACILITY IS ACTIVE 

07 CAT MFT SUPPORT FACILITY INVALIDATION REQUESTED 
09 SITE.MFT DOES NOT EXIST 


Messages 07 and 09 are only displayed for SYSADMIN. 


Message 07 describes the temporary state occurring when a request has been made 
to deactivate MFT (via the command VALIDATE _MFT_FACILITIES) but certain 
files under the control of MFT have not yet been closed. When these files are 
closed, MFT moves to the status described in message 01, which means that no 
files or tapes remain under the control of MFT and no file or tape information is 
added or updated in the SITE.MFT file. 
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Notes to User 


e The System Administrator (SYSADMIN project) and other users (with projects 
other than SYSADMIN) can use this command. 

e To send the status of MFT to a GCL global variable using OUTAREA, make 
sure that you first declare the GCL global variable. 

e Ifyou specify a global variable using OUTAREA, only the number of the 
appropriate message is sent to that variable. 


Examples 


DMFTF ; 
{In GCL (IOF), you ask to display the status of MFT, 
and the following message is displayed: 
02 CAT MFT SUPPORT FACILITY IS ACTIVE } 


GB MYVAR CHAR 2 ; 

DMFTF OUTAREA=MYVAR ; 
{You are a user not in the SYSADMIN project. You declare 
the GCL global variable MYVAR; then you execute the 
DISPLAY MFT FACILITIES directive, asking that the 
result (the status of MFT) be sent to MYVAR. MYVAR now 
contains the value 02, which means that MFT facility is 
activated for cataloged files. } 


EXDIR 'DMFTF'; 
{You execute the DISPLAY MFT FACILITIES directive using 
the JCL statement EXDIR} 
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7.6.32 DISPLAY_MIRROR_MODE (DMIR) 
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Purpose 


Displays the current operating mode for the mirrored disks. It can be either 
AUTOMATIC or MANUAL. 


Syntax 

{ DISPLAY MIRROR_MODE } 
{ DMIR } 
Parameters 


None. 


Rules 
Refer to Mirror Disks User's Guide. 


Examples 

DMIR Displays the message: 
"MR16 MANUAL MIRROR MODE" or 
"MR16 AUTOMATIC MIRROR MODE" 
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7.6.33 DISPLAY_MOT (DMOT) 


Purpose 


Displays the current value of the Message Of Today (MOT) which has been set by 
command MODIFY MOT. 


Syntax 


{ DISPLAY MOT } 
{ DMOT } 


[ { SYSTEM } ] 


[ { } = name4 ] 
{ sys } ] 


Parameters 


SYSTEM This parameter indicates the system where the 
command will be executed. 


Rules 


None. 


Example 


DMOT (Display the Message Of Today.) 
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7.6.34 DISPLAY_OUTPUT (DO) 


Purpose 


Displays the current status of outputs. Outputs may be selected according to the job 
to which they belong (OUTPUT parameter) or to their current state in the system 
(STATE parameter). The display shows for each output its name, priority, class, 
device (PR = printer), state, station, size and number of copies. 


Syntax 
{ DISPLAY OUTPUT } 
{ DO } 
{ (output14 [ outputl4 ] ...) } ] 
OUTPUT = { output14-outputl14 ] 
{ * | ALL yd 


SELCLASS = a [-a] ] 


{ QUEUE } ] 
STATE = { WAIT } ] 
{ HOLD } ] 
{ dOUTY © A] 
{ STATION } { * }] 
{ }= {An ji] 
{ ST }  { names } ] 
[ { SELECT } { user/project } ] 
U4 } = { */project } ] 
[ { es na 
[ { SEL ee ae }] 
{ JOBNAME } ] 
} = names ] 
{ JNM } ] 


SIZE = { bool | 0 } ] 


{ SYSTEM } ] 
} = name4 ] 
{ sys } ] 
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Parameters 


OUTPUT Output(s) to be displayed. The following formats are 
allowed: 


1. a list of the names of up to 16 outputs: 

- Xnnnn:nnnn } to refer toa specific 

output 
} (Xnnnn:name means 

the first output 

- Xnnnn:name } so named) 

- Xnnnn to refer to all outputs 
of a job. 


2. a range of outputs delimited by a lower and 
an upper boundary. This may take the 
following form only: 

- Xnnnn-Xnnnn to refer to all outputs of a 
range of jobs. The first ron must be lower 
than the second. 


3. to refer to all outputs of all jobs, specify: 
- * or ALL (default when JOBNAME is 
specified) 


If neither OUTPUT nor STATE are specified, the 
scope of the command is restricted to only the outputs 
of the OPERATOR job (or of the IOF job 
corresponding to the IOF user submitting the 
command). 


SELCLASS (meaningful only for output names in the form Xnnnn) 
restricts the scope of the command to those outputs 
that belong to a certain class or range of classes. This 
may be expressed as: 


class for a single class 
class-class forarange of classes 


where class is a letter in the range A to Z. 
When omitted, all classes are assumed (A-Z). 


STATE the current state of the outputs to be listed. This may 
be expressed as OUT (for currently being output), 
HOLD (for held), WAIT (for waiting to be output), or 
QUEUE (for any of the preceding). 
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STATION 


SELECT 


JOBNAME 


SIZE 


SYSTEM 


Rules 
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(with STATE) further qualifies the outputs to be listed 
by naming the station to which they are attached (* 
and ALL stand for any station). When omitted, the 
default station is assumed. 

(with OUTPUT) restricts the scope of the command to 
the specified station. When omitted, or when * or ALL 
is specified, there is no station restriction. 


restricts the scope of the command to outputs 
belonging to a specified user and/or project. Not 
meaningful when OUTPUT specifies a list of outputs 
(format 1) or when STATE is specified. By default, 
only the outputs belonging to the command submitter 
are selected. 


restricts the scope of the command to the outputs of 
jobs with the name specified. If JOBNAME is 
specified, the default value for OUTPUT is *. 


when | (meaningful only when STATE is specified), 
the number of lines and pages of the queued outputs is 
displayed. Default is 0. 


indicates the system on which the command is to be 
executed. 


e SELCLASS is ignored for names of specific outputs (Xnnnn:nnnn or 


Xnnnn:name). 


e OUTPUT and STATE are mutually exclusive. 


e Ifneither OUTPUT or STATE is specified, the command only concerns the 
outputs of the OPERATOR job (or the IOF job corresponding to the IOF user 
submitting the command). 


e If SELECT is used, OUTPUT and/or JOBNAME must be used. 
e STATE and JOBNAME are incompatible. 


e If JOBNAME is used, the only allowable values for OUTPUT are "*", "ALL", 
or "Xnnnn-Xnnnn" or unspecified. 
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Examples 


DO 


DO 


DO 


DO 


DO 


DO 


DO 


DO 


DO 


DO 


DO 


DO 
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STATE=QUEUE 


{display only the outputs of the OPERATOR or IOF 
job. See constraints above. 


{display all outputs, belonging to the command 
submitter, in the queue of the current or specified 
station} 


STATE=HOLD STATION=ST1 


X2345 


X2345 Z 


X2345 P-Z 


X2345:2 


{display all held outputs, belonging to the command 
submitter, that are attached to station ST1} 


{display all outputs of X2345} 
{only those in class Z} 
{only those of classes P to Z} 


{display specified output} 


(X2345:1 X2345:RES) 


{display two specified outputs } 


STATE=QUEUE SELCLASS=W SIZE=1 


STATE=WAIT 


{display the queued, class W outputs with their 
number of lines and pages} 


{display all queued outputs in the WAIT state} 


X123-X2617 SELECT=U1/P1 


JOBNAME=JOB1 


{display the outputs, belonging to user U1 of project 
P1, of the jobs whose RON is in the range X123 to 
X2617} 


{display all the outputs, belonging to the command 
submitter, of all jobs named JOB1} 
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7.6.35 DISPLAY_POWER_TIMER (DPWRTM) (DPWR) 


Purpose 
This command displays the values of both GCOS 7 power timers: 


The Power Off Timer, indicating at what time the system will shut down, then 
powered off; 


The Power On Timer, indicating at what time the system will power on. 


Syntax 

{ DISPLAY POWER_TIMER } 
{ DPWR } 
{ DPWRTM } 
Rule 


This command is not available on DPS 7000/2X0 or 3X0. 


Example 


DPWR (Displays values of power-off and power-on timers.) 
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7.6.36 DISPLAY_REGULATION_PARAMETER (DRP) 


Purpose 


This command to displays the main memory size in Mbytes and the dedicated I/O 
cache size in Mbytes. It also displays the current level (Full or Basic) and state 
(Normal or Degraded) of the Automatic Resource Manager (ARM). 


See the ARM User's Guide for full details. 


{ DISPLAY REGULATION PARAMETER } 


{ DRP } 
[ { SYSTEM } ] 
[ { } = name4 ] 
[ { sys } ] 
Parameters 
SYSTEM The system on which the command is executed. 
Rules 
None. 
Example 
DRP {displays the following information: 


MEM = 128MB 
IOMEM=256MB 
LEVEL = FULL STATE = NORMAL 


where MEM is the main memory size of the system 
and IOMEM is the dedicated I/O cache size. The 
physical memory size is MEM + IOMEM} 
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7.6.37 DISPLAY_REQUEST (DR) 


Purpose 
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Display all pending requests either from the system or from jobs in execution. 


Syntax 


{ DISPLAY REQUEST } 


{ DR 


[NUMBER 


[ { SYSTEM } 
vat 
[ { sys 


Parameters 


NUMBER 


SYSTEM 


Rules 


None. 


Examples 
DR 


DR NUMBER 
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{ bool | 0 } ] 


] 


= name4 ] 


] 


When 1, only the number of pending requests is 
displayed; when 0 or not specified, all pending 
requests are displayed. 


This parameter indicates the system where the 
command will be executed. 


{display all pending requests} 


{display the number of pending requests} 
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7.6.38 DISPLAY_RESTART_OPTIONS (DRSO) 


Purpose 


Displays some of the system initialization parameters. 


Syntax 


{ DISPLAY RESTART OPTIONS } 
{ DRSO 
[ ISLOPT = {bool | 0}] 


Parameters 


ISLOPT When 0 (default value), displays: 
- the automatic repeat option, 
- the automatic restart option, 
- the silent restart option, 
- the initialization device supporting the system disk. 


The meaning of this options is fully described in the 
example below. 


When 1, displays: 

- the initialization options of the current GCOS 7 
session, 

- additional sorted lists of current resident and shared 
disks (if any), 

- the current TIMEDEV value, 

- the four options mentioned above (when 0). 


The initialization options are BKST, DATE, DISK, 
DUMP, DUMP. CD, HA, INIT, LIB, MAM, 
NSYSSTUP, PAGESIZE, PVMF, REFORMAT, 
REPEAT, RESIDENT, RESTART, RESTORE, 
SHARED, SPOOL, SYSQM, TIMEDEV, TRC and 
TVMF. These options are completely described in 
Chapter 3 Starting and Terminating a GCOS 7 Session. 


Note that the initialization options values displayed are 
those entered at ILO1 question. Modifications on 
resident or shared disks, TIMEDEV and automatic 
restart or repeat options are reflected in the information 
displayed after the initialization options. 


7-122 47 A2 53US 


Description of the Operator Commands (Part 1) 


Rules 

None. 

Example 

DRSO {display some of the initialization parameters} 
16.13 AUTO=0/0 SILENT=0/0 REPEAT=0 


SYSTEM DUMP AVAILABLE 
ANTESP AUTO SWITCH IS OFF INIT=MS17 


The boolean values in the display indicate the initialization options used for the 
session; all possible values are given below: 


AUTO =0/0 
current t i next 
session session 
current-auto if this parameter is 0, the current ISL has been done in 
manual mode; if 1, the current ISL has been done in 
automatic mode. 
next-auto If this parameter is 0, the next ISL will be done in 
manual mode; if 1, the next ISL will be done in 
automatic mode. 
SILENT =0/0 
current i { next 
session session 
current-silent If this parameter is 0, the current ISL has not been 
performed silent; if 1, the current ISL has been 
performed silent. 
next-silent If this parameter is 0, the next ISL will not be 
performed silent; if 1, the next ISL will be performed 
silent. 
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REPEAT 


ANTESP 


Example 


DRSO ISLOPT=1 


INITIALIZATIONS 


BKST 
DATE 
DISK 
DUMP 
DUMP_CD 


EPEAT 


SYSQM 
TIMEDEV 
TRC 
TVMF 
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If this parameter is 0, the next system shutdown or 
crash requires a manual intervention from an operator 
to restart the system; if 1, the next system shutdown or 
crash is followed by a restart without any operator 
intervention. 


or ASPA (Ante Service Processor). On 

DPS 7000/2x0/3x0, sets a number of configuration 
parameters. See Section 2.3.3 ASPA Configuration 
Parameters on the DPS 7000/2x0 and /3x0. 


OPTIONS 17:44:02 FEB 26, 1997 
/, BFROSS 
MM.DD. YY/HH.MM 


= ISL OPTIONS. .RELOAD OPTIONS: BFS753 


CONS 


ON 
NAUTO 


= /,BFRO54 
= YES 


11*6 
/ 


OFF 

BFS753, BFRO54, BFRO55 
CLEAN 

SYS .SYSTEM: BFS753 
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CURRENT LIST OF RESIDENT DISKS 
BFRO54 
BFRO55 
BFS753 


CURRENT LIST OF SHARED DISKS 
BFU023 


CURRENT TIMEDEV = +01:00 

17.44 AUTO = 1/0 SILENT = 0/0 REPEAT = 0 
SYSTEM DUMP UNAVAILABLE 
ANTESP AUTO SWITCH IS OFF INIT = MS53 
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7.6.39 DISPLAY_RMS (DRMS) 


Purpose 


This command displays information on the Remote Maintenance Service. 


Syntax 
{ DISPLAY RMS } 
{ DRMS } 
Parameters 
None. 
Rules 


This function is only available on DPS 7000/An and DPS 7000/500/700 systems. 


Example 


DRMS Various information concerning the current state of 
RMS is displayed on the operator's screen. 
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7.6.40 DISPLAY_SECURITY_OPTIONS (DSO) 


Purpose 


This command displays the security options of a site declared by the SECOPT and 
SADMOPT statements of CONFIG, and recorded in the SITE.CATALOG. 


Syntax 
{ DISPLAY SECURITY OPTIONS } 
{ DSO } 
Parameters 
None. 
Rules 
None. 
Example 
DSO (Produces the display shown below:) 
hh.mm SECURITY OPTIONS FOR: sitename ON: date ARE: 
1 PROJECT/USER CHECKS={YES |NO} 
1 PROJECT/BILLING CHECKS={YES|NO} 
1 PROTECTED SYSTEM (ACCESS RIGHTS) ={YES|NO} 
2) hh.mm SA7LOGON={YES|NO} SA7ADMIN={YES|NO} SA7NOCSL={YES|NO} 
3 NETSEC ={YES|NO} CHKPW =YES|NO ERASE ={YES|NO} 
hh.mm SYSADMIN OPTIONS ARE: 
4 CHKJSADM={YES|NO} GCLKPROJ={YES|NO} GCLKSADM={YES|NO} 
5 GCSADMOP={YES|NO} MIRROR={YES|NO} 


Lines (1), (2), and (3) display the parameters of the SECOPT option of CONFIG. 
Lines (4) and (5) display the parameters of the SADMOPT option of CONFIG. 
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Description of Message Entries 
PROTECTED SYSTEM (ACCESS RIGHTS): 
This option defines the access rights recorded in the SITE.CATALOG. 


=YES File access is checked with the rights defined in the 
SITE.CATALOG. 
=NO File access is unrestricted for all users. 


CHKJSADM (SADMOPT parameter): 


This option defines the restriction of job submission under SYSADMIN. 


=YES: GCOS 7 checks that users running jobs for 
SYSADMIN are cataloged under the SYSADMIN 
project. 

=NO: Job submission under SYSADMIN is unrestricted. 


CHKPW (SECOPT parameter): 


This option determines if the password is to be checked; applicable where the 
project of the user submitting the request has been defined with either UFT, DJP, 


or SPOOL in the catalog. 
=NO: default: password is not checked. 
=YES: the site receiving the request checks the password of 


the user submitting the job (the password can be 
provided when the command is submitted). 


GCLKPROJ (SADMOPT parameter): 


This option defines the user access to GCL procedures specifying LOCK in the 
PROC statement. 


=YES: access is available to any user under the same project 
as the user compiling these procedures. 


=NO: access is limited only to the user compiling these 
procedures. 


7-128 47 A2 53US 


Description of the Operator Commands (Part 1) 


GCLKSADM (SADMOPT parameter): 


This option defines the SYSADMIN access to GCL procedures specifying LOCK 
in the PROC statement. 


=YES: users under the SYSADMIN project have the same 
rights of access as the user compiling these procedures. 


=NO: users under the SYSADMIN project have no 
additional access rights. 


GCSADMOP (SADMOPT parameter): 


This option defines the SYSADMIN access to Main Operator commands through 
EXDIR. 


=YES: users under the SYSADMIN project have the same 
rights as the Main Operator. 

=NO: users under the SYSADMIN project are normal IOF 
users. 


MIRROR (SADMOPT parameter): 
Defines if MIRRORED disks are used. 
=YES: duplicate WRITEs on 2 disks. 
=NO: no MIRRORED disks. 
NETSEC (SECOPT parameter): 
This option defines how connections are to be checked. 


=YES: connections always go through the front-end processor 
which performs security checks using LACS software. 


=NO: local connections are checked by GCOS 7. 
SA7ADMIN (SECOPT parameter): 
This option defines how the user administration of the site is performed. 
=YES: administration is performed by SECUR'ACCESS. 


=NO: administration is performed by SYSADMIN through 
catalog management (MNCAT). 
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SA7LOGON (SECOPT parameter): 
This option defines how the user's access rights are to be checked. 


=YES: user rights to access TDS/IOF applications are checked 
by SECUR'ACCESS at connection time. 


=NO: access rights are checked by GCOS 7. 
SA7NOCSL (SECOPT parameter): 


This option defines if SECUR'ACCESS checks the identity of the user logging on 
to the local system console. 


=NO: the user's identity is checked by SECUR'ACCESS; 
meaningful only if SA7LOGON=YES. 


=YES: the user's identity is checked by GCOS 7. 


For further information, refer to the GCOS 7 System Installation Configuration and 
Updating Guide. 


Example 
S: DSO; 


14.16 SECURITY OPTIONS FOR : BPA6 ON: OCT 10, 1995 ARE: 


PROJECT/USER CHECKS = YES 
PROJECT/BILLING CHECKS = NO 
PROTECTED SYSTEM (ACCESS RIGHTS) = YES 
14.16 SA7LOGON = NO SA7ADMIN = NO SA7NOCSL = NO 
14.16 NETSEC = NO CHKPW = NO ERASE = NO 
SYSADMIN OPTIONS ARE: 
CHKJSADM = NO GCLKPROJ = NO GCLKSADM = NO 
GCSADMOP = YES MIRROR = YES 
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7.6.41 DISPLAY_SERVICE (DSRV) 
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Purpose 


The operator uses this command to obtain the state of the different instances of a 
SERVICE on the MEMBERs of a COMPLEX. This command is a part of the High 
Availability product (HA). For more information, see the High Availability 
Administrator's Guide. 


Syntax 
{ DISPLAY SERVICE } 
{ DSRV } 
{ SERVICE } 
{ } = names 
{ SRV } 
[ { 0 }] 
[ STATE = { }] 
[ { bool } ] 
[ { MAIN SERVICES }} { 0 }] 
C { d= { bd 
[ { MSRV } = { bool } ] 
[ { USED SERVICES } { 0 }] 
Ef d= { a 
[ { USRV } = { bool } ] 
[ { DETAILED } { 0 }] 
C { p= { }] 
[ { DTLD tf Boots “ba 
Parameters 
SERVICE Name of the SERVICE. 
STATE When entered, gives only the two states of this 
SERVICE (required and effective). 
USED_SERVICES When entered gives only the list of the 
USED_SERVICEs of this SERVICE. 
MAIN_ SERVICES When entered gives only the list of the MAIN 


SERVICEs of this SERVICE. 
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DETAILED When entered, gives more detailed information on the 
states of this SERVICE. 


Rules 
The CMSR of the MEMBER on which this command is entered must be running. 
The SERVICE must be in the COMPLEX description. 


Examples 


DSRV SRV=TDS1 
Displays all information about the SERVICE named TDS1. 


DSRV SRV=TDS1 USRV 
Displays only information about the USED_SERVICEs of the SERVICE named 
TDS1. 


DSRV SRV=TDS1 STATE 
Displays only information about the state of the SERVICE named TDS1. 
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DISPLAY_SSI (DSSI) 


47 A2 53US 


Purpose 


Displays the status of the SSI (Storage Server Interface). It indicates whether the 
SSI processes on OPEN 7 are active or not. SSI is a component of the CLX product 
(Cartridge tape Library uniX server). 


Syntax 


{ DISPLAY SSI } 
{ DSSI } 


Parameters 


None 


Example 1 
DSSI is entered while SSI is inactive 


S: DSSI 

11.15 X549 IN CLX SSI USER=OPERATOR CLASS=P SPR=6 STATION=BCA9 
11.15 X549 STARTED CLX SSI OPERATOR P 

JB0O8 X549.1 STEP H CLX CMDSSI XPR=8 PGID=22 

TU70 ACSEL AND SSI NO MORE RUNNING 

11.15 X549.1 COMPLETED CLX SSI OPERATOR P 


Example 2 


DSSI is entered while SSI is active 


S: DSSI 

11.17 X551 IN CLX SSI USER=OPERATOR CLASS=P SPR=6 STATION=BCA9 
11.17 X551 STARTED CLX SSI OPERATOR P 

JBO8 X551.1 STEP H CLX CMDSSI XPR=8 PGID=22 

TU70 ACSEL AND SSI ARE RUNNING 

11.17 X551.1 COMPLETED CLX SSI NA OP P 
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7.6.43 DISPLAY_STORAGE_FACILITIES (DSF) 


Purpose 


Displays the status (active or not active) and the level (basic or full) of the 
VOLSET and QUOTA facilities. 


Syntax 


{ DISPLAY STORAGE FACILITIES } 
{ } 
{ DSF } 


[ OUTAREA = name31 ] 


Parameters 


OUTAREA the name of the GCL global variable that will receive 
the message numbers of the messages output by the 
DSF command. The global variable must be declared 
with: 


TYPE = CHAR 
LENGTH = 6 (at least) fora SYSADMIN user 
LENGTH = 4 (at least) for any other user 


When DSF is executed, the global variable referenced 
by OUTAREA is set as follows: 


— the first two characters give the status of the 
QUOTA facility (01 or 02) 

— the next two characters give the status of the 
VOLSET facility (03, 04, or 05) 

— the fifth and sixth characters are available only if the 
command submitter is a SYSADMIN user; they 
give complementary information (06, 07, 08, 09, 10, 
or 11) 


If OUTAREA is omitted, the result is displayed on the 
current output media defined for the active domain. 


Rules 


The GCL variable name specified in OUTAREA must be different from the 
keyword names of GCL procedures. 
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Command Output 


O01 QUOTA FACILITY IS NOT ACTIVE 

02 QUOTA FACILITY IS ACTIVE 

03 VOLSET FACILITY IS NOT ACTIVE 

04 BASIC VOLSET FACILITY IS ACTIVE 

05 FULL VOLSET FACILITY IS ACTIVE 

06 VOLSET FACILITY VALID BUT NOT ACTIVE, SITE VOLSET NOT CREATED 
07 VOLSET FACILITY IS NOT VALID 

08 SITE.QUOTA FILE DOES NOT EXIST 

09 THE SYSTEM HAS ITS OWN VOLSET 

10 THE SYSTEM HAS ITS OWN SHARABLE VOLSET 

11 SITE VOLSET IS SHARED AND HAS BEEN DEFINED ON THE OTHER SYSTEM 


Messages 06 to 11 are not issued to non-SYSADMIN users. 


Examples 


DSF {for a non-sysadmin user, this displays: 
02 QUOTA FACILITY IS ACTIVE 
03 VOLSET FACILITY IS NOT ACTIVE} 


{for a sysadmin user, this displays: 

02 QUOTA FACILITY IS ACTIVE 

03 VOLSET FACILITY IS NOT ACTIVE 

06 VOLSET FACILITY IS VALID BUT NOT ACTIVE; SITE VOLSET 
NOT CREATED} 


GLOBAL MY VAR CHAR 6 

DSF OUTAREA=MY VAR 
{for a non-sysadmin user, the variable MY_VAR=0203 
for a sysadmin user, the variable MY_VAR=020306} 
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7.6.44 DISPLAY_SUBMITTER (DS) 
Purpose 
Display the current status of selected jobs, with the selection based on their 
respective submitter. 
Syntax 
{DISPLAY SUBMITTER} 
{Ds } 
{jstate }] 
{jtype }] 
[ JOBID = {( ss jtype) }] 
[ {Xn }] 
ee }] 
{SELECT} {jclass} [ {usernm} [  {projnm}]]] 
{ het cys Poe Sf }11] 
{SEL }  {* [  {* an ee ane 
[{STATION {* ] 
[{ }= {ALL }] 
{ST } {names }] 
JOBNAME = name8] 
{200 }] 
LIMIT = {20 }] (See parameter description for default value) 
{dec4}] 
{ SEQUENCE {PRIORITY |DECR_ITIME|INCR_ITIME}] 
= { | | }] 
{SEQ { | DIT | IIT }] 
{ DETAILED ] 
{ = {bool|0}] 
{DTLD 
7-136 47 A2 53US 


47 A2 53US 


Parameters 


JOBID 


SELECT 


STATION 


JOBNAME 
LIMIT 


SYSTEM 
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the jobs to be displayed designated by their Run 
Occurrence Number (Xnnnn), name (name-8), current 
state (jstate), type (jtype), or current state and job type. 


jstate must be one of the following: 
ALL, SCH, EX, SUSP, OUT, IDLE, IN, HOLD 


jtype be one of the following: 
ALL, BATCH, IOF, SERVICE, NSERVICE 
(NSERVICE means all jhobs except service jobs.) 


When JOBID is omitted, ALL is assumed. 


restricts the directive to the jobs that belong to the 
specified combination of class/submitter-name/project. 
* is all jobs. When omitted, all jobs submitted by the 
terminal user are displayed. 


restricts the list of jobs displayed to those that are 
attached to the named station (* or ALL stand for any 
station). When omitted, the current working station of 
the command submitter is assumed. 


the job to be designated by name (name-8). 


maximum number of jobs to be displayed. Beyond that 
limit, only the number of jobs per class is displayed. 
The default and maximum values are: 

When DETAILED=1, default 20, maximum 100 
When DETAILED=0, default 200, maximum 850. 


indicates the system where the command is to be 
executed. 
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SEQUENCE specifies the order in which jobs are to be displayed 
for each job state. The sort criterion can be the 
scheduling priority (keyword PRIORITY) or the 
introduction time (keywords DECR_ITIME and 
INCR_ITIME). The display order for each job state is 
determined by: 


— the scheduling priority (PRIORITY), from highest 
to lowest. The introduction time is used for second 
level sorting within each priority level. This is the 
default display criterion. 

— or the introduction time alone, (PRIORITY not 
specified): 

DECR_ITIME = from most recent to oldest 
INCR_ITIME = from oldest to most recent. 


DETAILED (abbreviation DTLD) specifies whether detailed job 
information is to be displayed. The information 
returned depends on the job state: 


HOLD - Hold count 
- Introduction time 
EX/ SUSP - Introduction time 
- Switches 


- Full load module name or step state 

- System internal identifier associated with the step 
- CPU and elapsed times for the current step 

- Number of processes, Backing store 

- Used and fixed instantaneous memory sets. 


It is not always possible to provide all of the above 
information for jobs in state EX or SUSP, in particular 
the ARM dimension (e.g. IOF, BATCH) and the step- 
specific information (load module name, step CPU and 
elapsed time, number of processes, backing store, 
memory sets). This is the case at step initialization (if 
the step is waiting for a resource statically assigned by 
a JCL statement or for resources in a dimension), and 
at step termination. 


OUT The introduction and termination times. 
These times may be unknown if the job is in the OUT 
state, and if they were kept after SYS.OUT recovery at 
system RESTART. 
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IN, SCH, IDLE The introduction time. 


When DETAILED=1, LIMIT may not exceed 100 and 
the default value is 20. 
Rules 


e when JOBID is in the form Xnnnn, SELECT, STATION and LIMIT are ignored. 
e JOBID and JOBNAME are mutually exclusive. 


Examples 

S:DS {Display the status of all jobs submitted by the 
terminal user that are attached to his current working 
station. } 

S:DS EX {Display the status of all executing jobs submitted by 
the terminal user that are attached to his current 
working station. } 

S:DS SCH {Display the status of all scheduled jobs submitted by 
the terminal user that are attached to his current 
working station. } 

S:DS X222 {Display the status of the job with RON X2272.} 

S:DS EX* {Display the status of all executing jobs that are 


attached to the current working station of the 
command submitter. } 


S:DS ALL */JONES {Display the status of all jobs submitted by JONES 
that are attached to the current working station of the 
command submitter. } 


S:DS EX */*/PROJ {Display the status of all executing jobs submitted 
under project PROJ.} 


S:DS PAYROLL {Display the status of all jobs named PAYROLL 
submitted by the terminal user that are attached to his 
current working station.} 


S:DS BATCH C {Display the status of all batch jobs in class C attached 
to the current working station of the command 
submitter. } 
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S:DS EX ST=ST1 {Display the status of all executing jobs submitted by 
the terminal user that are attached to station ST1.} 


S:DS (EX NSERVICE) * 


{Display the status of all executing jobs that are not 
service jobs and that are attached to the current 
working station of the command submitter. } 


S:DS (HOLD BATCH) DETAILED 
{Display detailed information about held batch jobs 
for which USER is the command submitter and that 
are attached to his current workstation. } 
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7.6.45 DISPLAY_SYSTEM_TRACE (DSYSTR) 


Purpose 


This command displays, on the main console, trace object identifiers and their 
status. If the selected object is a single buffer or domain, the display details its 
attributes; otherwise, a list of the selected object identifiers is produced. The 
command can be issued at any time, but system trace files exist only during 
collector execution. 


NOTE: 
Use this command only under the direction of your Bull support engineer. 


{ DISPLAY SYSTEM TRACE } 


{ DSYSTR } 
[ { DOMAIN } { ALL } 
[{ DM je={ } 
[ { TDoM } — { name63 } 
[ { BUFFER } { ALL } 
[ { y= { } 
[ { BFR } { name6 } 


[ FILES = bool ] 


Parameters 

DOMAIN: the name of a system domain, or if ALL (the default) is 
specified, all domains. Maximum length is 63 
characters. 

BUFFER: the name of a system trace buffer, or if ALL is 
specified, all system trace buffers. Maximum length is 
6 characters. 

FILES: if 1, system trace collector file names are displayed; if 


0, the file names are not displayed. 
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Rules 
The parameters DOMAIN, BUFFERS, and FILES are mutually exclusive. 


Examples 
DSYSTR {Display active domain names. } 


DSYSTR DOMAIN=JOBM {Display attributes of JOBM trace domain} 


DSYSTR BUFFER=ALL {Display the names of all trace buffers} 


DSYSTR BUFFER=BFRSYS 
{Display the characteristics of trace buffer BFRSYS} 


DSYSTR FILES {Display system trace collector file names} 
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7.6.46 DISPLAY_TERMINAL_OUTPUT (DTO) 
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Purpose 


Displays the characteristics and status of outputs to be printed by the Generalized 
Terminal Writer. Refer to the Generalized Terminal Writer User Guide for a 
complete description of the Generalized Terminal Writer. 


Syntax 


{DISPLAY TERMINAL OUTPUT} 
{DTO } 


= Xnnnn 
neat = namel2 


[ { }] 
[ { }] 
[STATE = {WAIT}] 
[ {OUT }] 
[ {MNT }] 
[ { }] 


[DETAILED = {bool | 0}] 


Parameters 


OUTPUT the name of the output to be displayed. A Generalized 
Terminal Writer output name has the form Rnnnn and 
is provided as the result of the DPRINT command 
(with parameter TWDEST). When none of OUTPUT, 
USER, RON and TWDEST is specified, all outputs 
belonging to the terminal user are displayed. 


USER when specified, all Generalized Terminal Writer 
outputs belonging to the user specified by USER are 
displayed. When none of OUTPUT, USER, RON, and 
TWDEST is specified, all outputs belonging to the 
terminal user are displayed 
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RON 


TWDEST 


SELCLASS 


STATE 


DETAILED 


Rules 


when specified, all Generalized Terminal Writer 
outputs submitted by the job with this Run Occurrence 
Number are displayed. When none of OUTPUT, 
USER, RON and TWDEST is specified, all outputs 
belonging to the terminal user are displayed. 


when specified, all Generalized Terminal Writer 
outputs to be printed on this terminal or pool of 
terminals are displayed. When none of OUTPUT, 
USER, RON, and TWDEST is specified, all outputs 
belonging to the terminal user are displayed. 


restricts the scope of the directive to those outputs that 
belong to a certain class (SELCLASS = a) or range of 
classes (SELCLASS = a-a). 


restricts the scope of the directive to those outputs that 
have the specified status: OUT (being printed), WAIT 
(waiting for printing), HOLD (held), FRZN (frozen), 
CNCT (connecting to printer), or MNT (wait for paper 
to loaded). 


when 1, detailed information for each output is 
provided; when 0 (the default value) a one line status 
message is given for each selected output. 


OUTPUT, USER, RON and TWDEST are mutually exclusive. 


Examples: 


DTO 


{display all the terminal user Terminal Writer outputs} 


DTO R12345 DETAILED 


DTO STATE=WAIT 


DTO TWDEST=POOL3 
STATE=WAIT 


{display detailed information for the output R12345} 


{display the terminal user's output waiting for 
printing} 


{display all outputs waiting for printing on pool 
POOL3} 
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7.6.47  DISPLAY_TERMINAL_WRITER (DTW) 
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Purpose 


Displays miscellaneous information relating to the Generalized Terminal Writer. 
Refer to the Generalized Terminal Writer User Guide for a complete description. 


Syntax 


{ DISPLAY TERMINAL WRITER } 


{ DTW 


} 
TERM }] [ { name12 } ] 
Hs hf AE oF 
T ] [ { POOL }] 
= names ] 


[ NODE = names ] 


[ DRIVER = name4 ] 


it 
C { 
[ { 


TWRITER } ] 


ww 
ll 
oy 
e) 
oO 
| 


TW 


[ DETAILED = { bool | 0 } ] 


[ FORM = { * | name6 } ] 


Parameters 


TERM 


ID 


NODE 


DRIVER 


the name of the terminal for which information is to be 
displayed. If * or ALL is specified, all terminals are 
assumed. If POOL is specified, information concerning 
the terminal pools is displayed. 


when specified, the information to be displayed is that 
relative to the terminal whose identification in the 
generation is given by ID parameter. 


(only when ID is specified) qualifies the node for 
which ID is specified. 


display information for the named driver. 
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TWRITER 


DETAILED 


FORM 


Rules 


when 1, general information on the Generalized 
Terminal Writer is displayed. 


when 1, information provided is detailed; when 0 (the 
default value), brief information is provided. 


the name of the form for which information is to be 
displayed. If the asterisk (*) is specified, the 
information on all the forms is displayed. 


e TERM, ID, DRIVER and TWRITER are mutually exclusive. 


e NODE may be used only in conjunction with ID. 
e When TWRITER is 1, DETAILED is ignored. 


Examples 
DTW POOL 
DTW DRIVER=TWO02 


DTW * 


DTW TWRITER 
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{display the pools} 
{display driver TW02} 
{display all terminals} 


{display global information on Terminal Writer} 
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7.6.48 DISPLAY_TIME (DTM) 


Purpose 


Displays the date and time of day. 


{ DISPLAY TIME } 
{ DIM } 


Parameters 


None. 


Rules 


None. 


Example 


DTM {display the date and time} 
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7.6.49 DISPLAY_USER_REQ (DUR) 


Purpose 


Displays the current status of file transfer or jobset requests. 


Syntax 

{ DISPLAY USER_REQ } 

{ DUR } 
[ { ALL }] 
[ REQUEST = { }] 
[ { name8 [name8] ...) }] 


[ { SUBMITTER } ] 
fc } = usernm [.projnm] ] 
[ { SELECT } ] 


[ USER = usernm [.projnm] ] 


[ JOBNAME = bool] 
[ DETAILED = {0|bool}] 


Parameters 


REQUEST a list of up to 16 names of requests whose statuses are 
to be displayed. Each name may take one of the 
following forms: 


— Jnnnnnnn a Jobset Occurrence Number (JON), 

— Fnnnnnnn a File transfer Occurrence Number 
(FON), 

— name-8 the symbolic name of a request as specified 
by the NAME parameter of the ENTER JOB REQ 
or ENTER _FILETRANS REQ commands. 


JONs and FONs are provided as results of the 
ENTER JOB REQ and ENTER FILETRANS REQ 
commands. They are unique identifiers for the 
corresponding requests. 
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SUBMITTER 


USER 


JOBNAME 


DETAILED 


Rules 
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(meaningful only when REQUEST is ALL) restricts 
the display to the requests submitted by the named 
user, possibly further restricted to the named project. 
When SELECT is not specified, the terminal user 
name is assumed. 


This is the same as the preceding parameter except that 
the USER address requests submitted on behalf of the 
secondary submitter (parameter USER= of EJR). 


This parameter is useful to locate specific job requests 
when there are a large number of requests. It shows 
either the subfile name or the file name for job 
requests. 


is meaningful only when REQUEST=ALL, 

if = 1: displays all information as for 
REQUEST=name8 (Request-name), 

if = 0: (default value): displays only the list of 
requests. 


e SELECT and DETAILED are ignored when REQUEST is not ALL. 
e DETAILED is meaningful when REQUEST is ALL. 
e SUBMITTER and USER are mutually exclusive. 


Examples 
DUR or DUR ALL 


DUR ALL JONES 


DUR 
SELECT=JONES . PREP 


DUR (F22 J44 RQP) 


DUR ALL DETAILED 
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{display the list of all terminal user's requests} 
{display the list of all JONES' requests} 

{display the list of all JONES' requests under project 
PREP} 

{display three requests} 


{displays the list of all terminal user's requests with 
detailed information} 
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7.6.50 DISPLAY_XL_CLASS (DXLC) 


Purpose 


Displays the current values associated with an XL class. See the ARM User's Guide 
for full details. 


Syntax 


{ DISPLAY XL CLASS } 
{ DXLC } 


[ { XL_cuass } { dec2 } ] 


[ { b= { } 1 
[fxn ty ee 
[ { SYSTEM } ] 
[ { } = named ] 
[ { sys } ] 
Parameters 
XLC The identity of the Execution Level Class to be 
displayed (0 to 10). If it is not specified then all the 
classes are displayed. 
SYSTEM This parameter indicates the system where the 


command will be executed. 
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Example 


S: DXLC XLC=3; 


00.35 XLC ATTR 
3 FS 


ATTR 


HPRTYRANGE 


EPRTY 


MAXCPU 


<HPRTYRANGE> EPRTY 
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MAXCPU 
12 13 12 90 


There are three possible control modes: Fixed 
non-sliced (F), Fixed sliced (FS), or Optimized (O). 


Range of hardware priorities that a process is allowed 
belonging to this execution level class, ranging from 0 
to 15. 


This is the entry priority of a process. It is applicable 
only when ATTR=O and also it is the starting value of 
HWPRTY (See MDXLC). 


The maximum CPU consumption rate a process may 
achieve before it is penalized, expressed as a 
percentage. 
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7.6.51 DPRINT (DPR) 


Purpose 


Requests the printing of a file or of subfiles on a printer; requests the printing of a 
file or subfile by the Generalized Terminal Writer (refer to the Generalized 
Terminal Writer User Guide. 


Syntax 

{ DPRINT } 

{ } 

{ DPR } 
[ SUBFILES = (star31 [star31] ...) ] 
[ LIB = 1ib78 ] 
[ CLASS = a ] 
[ PRIORITY = {0|1|2]3|4|5|6|7} ] 
[ WHEN = { IMMED | END } ] 
[ DEST = [name8.] names ] 
[ TWDEST = { name12 | * } ] 
[ NAME = name8 ] 
[ BANINF = (charl2 [charl12 [char12 [char12]]] ) ] 
[ COPIES = dec3 ] 
[ NUMBER = bool ] 
[ INFILE = file78 ] 
[ PAGE = (dec5 [-dec5] [dec5 [-dec5]]... [dec5 [-$])] 
[ OUTPUT = ( output14 [ outputl4] ...) ] 
[ HOLD = bool ] 
[ BANNER = { NO|YES|JOB|OUTPUT|COPY|MEMBER } ] 
[ SILENT = bool ] 
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[ { DEVCLASS } ] 
[ { } = device-class ] 
[ { Dvc } ] 
[ { MEDIA } ] 
[ { } = charé ] 
[ { MD } ] 


coal 


DELETE = bool ] 


[ SKIP = bool ] 


al 


DATAFORM = { SARF|SSF|DOF|ASA } ] 


al 


PRNAME = { bool | 0 } ] 


Parameters 


SUBFILES a list of up to 10 star-names denoting the names of the 
subfiles of LIB to be printed or punched. If you omit 
the SUBFILES parameter, you must specify a 
sequential file using the INFILE parameter. 


LIB the library holding the subfiles. When omitted, the 
default output SL library (#SLIB) is assumed. When 
DPRINT is launched from the main console or if 
TWDEST is specified, a cataloged library must be 
cataloged in either an auto.attach catalog or in the 
SITE.CATALOG. When TWDEST is specified, the 
library cannot be TEMPRY. 


CLASS the output class (a letter in the range A to Z). The 
default is defined by the installation. 


PRIORITY a number in the range 0 to 7. The lower the number, 
the higher the urgency. 


WHEN IMMED immediate enqueuing of the request, 
END enqueuing deferred to the end of the current 
session. 


DEST destination of the output expressed as [host-name. | 
station-name. See the JOF Terminal User's Manual, 
part 1, for details. 
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TWDEST 


NAME 


BANINF 


COPIES 
NUMBER 
INFILE 
PAGE 


OUTPUT 


Xnnnn: nnnn 
or Xnnnn: name 


Xnnnn 


HOLD 
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(Generalized Terminal Writer only) the name of the 
Generalized Terminal Writer terminal or pool of 
terminals where the output is to be printed. When * is 
specified, the default value defined when the 
Generalized Terminal Writer is generated, or modified 
by the MODIFY PROFILE directive (parameter 
TWDEST), is assumed. 


to appear in the result of the DISPLAY OUTPUT 
command. 


up to 4 12-character texts to appear on the output 
banner (from bottom to top). 


number of copies in the range | to 254. 
if 1, generate line numbers on the output. 
the file containing the text to be printed. 


a list of up to 10 pages or ranges of pages of the 
specified file to be printed. The ending value of the last 
range may be $, which means that the upper limit is 
the end of the file. 


a list of up to 10 outputs to select specific reports of a 
job. OUTPUT may take the following forms: 


to select a specific output 
to select all outputs of a job. 


OUPUT applies only if the specified file was produced 
via the Output Writers. 


if 1, output is held. The command 

RELEASE OUTPUT (or 

RELEASE TERMINAL OUTPUT, if TWDEST is 
specified) can subsequently be used to cancel the effect 
of this parameter. 
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BANNER 


SILENT 


DEVCLASS 
MEDIA 


DELETE 
SKIP 


DATAFORM 


PRNAME 
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if NO, banners are not printed at the beginning of each 
output. 


if YES, resets effect of NO. 


if JOB, asks for job level banners (default if 
WHEN=END). 


if OUTPUT, asks for output level banners. 


if COPY, asks for banners at output copy level. This is 
the default unless WHEN=END. 


if MEMBER, asks writer to insert banners between 
each member. 


(Generalized Terminal Writer only) if 1, no message is 
issued to the user when printing starts or is completed. 


the class of the device to be used. 


when TWDEST is not specified, the printer belt to be 
used. If not specified, the default is defined by the 
installation. When TWDEST is specified, the paper to 
be used on the terminal; if omitted, the default is the 
form currently mounted on the terminal specified by 
TWDEST. 


if 1, delete subfiles after printing. 


if 1 or omitted, any paper move instructions are 
obeyed when the file is printed. If 0, when the file is 
printed, every skip function is reduced to "skip to next 
line" (move to the next line). 


data format, as follows: 


SARF Standard Access Record Format 
SSF Standard System Format 

DOF Device Oriented Format 

ASA American Standard 


(meaningful only when SUBFILES is specified) if 1, 
the name(s) of the subfile(s) and their libraries are 
printed on the first line of the output. If 0 (default), 
these names are not printed. 
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Rules 

e INFILE and SUBFILES are mutually exclusive. One of the two must be 
specified. 

e LIB and DELETE may only be used when SUBFILES is used. 


e NAME, WHEN, DEST, BANNER, PAGE, OUTPUT, SKIP, and DEVCLASS 
are exclusive of TWDEST. 


e SILENT may be used only when TWDEST is specified. 

e BANINF and BANNER=0 are mutually exclusive 

e TWDEST and DATAFORM=DOF are mutually exclusive 

e PAGE and OUTPUT may be used only when INFILE is specified. 


e The parameters specified in $JOB with the EJ command or an anticipated MO 
(MODIFY OUTPUT) command override those specified in a batch job (OVL 
SYSOUT or WRITER), or in a IOF directive (DPR). 


Examples 


DPR SF1 {print member of current SL output library} 


DPR SF *MYPROJ.MYLIB 
BANINF= (, PR2, PRX) 
NAME=PR2 
COPIES=2 
{print two copies of all members beginning with SF, give a name 
to the output and specify banner lines 3 and 4} 


DPR (S* T*) MYPROJ.MYLIB 
CLASS=Z 
{print all members beginning with S or T in class Z} 


DPR INFILE=MYPROJ .MYF 
{print a sequential file} 


DPR MYSF MYPROJ.MYLIB TWDEST=* 
{print subfile MYSF of the specified library on the default 
Terminal Writer terminal attached to the user} 


DPR SUBFILES=SBFILE1 LIB=LB1 PRNAME=1 
{print the names SBFILE1 and LB1 on the first line of the 
output } 
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7.7 "E" Commands 


7.7.1 ENTER_FILETRANS_REQ (EFTR) 


Purpose 


Requests a file transfer. 


Syntax 


{ ENTER _FILETRANS REQ } 
{ EFTR 


INFILE = rfile78 
OUTFILE = rfile78 


[ APPEND = { bool | 


|o 


}] 
kal 


COMPACT = { 1 | bool } ] 


[ BINARY = { bool | 


|o 


al 


[ START = dec5 ] 


al 


RESTART = bool ] 


Coal 


USER = namel2 ] 

[ PROJECT = namel2 ] 

[ BILLING = namel2 ] 

[ PASSWORD = char12 ] 

[ RHOLD = bool ] 

[ RCLASS = a ] 

[ RPRIORITY = {0|1|2|3|4|5|6|/7} ] 
[ NAME = names ] 


IMMED 
[Imm.dd. lyy] yy]. hh.mm 


WHEN 


+dddd{w|D|H|M} 
when-clause 


ls lee le ee ee 


{ 
{ 
{ 
{ 
{ 


We We 
bees es 
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(es lee ee ee — Ce les Ol ee Bl ees ee 


ne! 


= 


coal 


cal 


Ce Dl ee Bl oes Be 


—= me 


RRESTART 


{ CREATE 


{ CR 
CATNOW 


EXPDATE 


DELETE 


SHARE = 


ACCESS 


OUTALC 


DENSITY 


( 


} 
} 


[ decS ] 


] 
] 
] 
] 
] 


[dec5] 


= {NO|NEW|KEEP|REPLACE} ] 


bool J 


= bool ] 


[yylyy.mm.dd ] 


{SL|CU|LM|SM|BIN} ] 


(file-define-parameters) 


} 
} 
} 
{ 


] 


] 


(file-define-parameters) ] 


rr 


] 
] 
] 
] 
] 


file-allocation-parameters ] 


bool | 0 } ] 


= 4 bool: | 03°] 


{6250|1600|800|556|200} ] 


) 


Parameters 
INFILE 
OUTFILE 
APPEND 


BINARY 


COMPACT 


START 


RESTART 


USER 


PROJECT/BILLING 


PASSWORD 
RHOLD 


RCLASS 


RPRIORITY 


NAME 
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the origin file or remote file. 
the destination file or remote file. 


if 1, append in OUTFILE; otherwise OUTFILE is 
overwritten. 


if 1, binary format transferred (for SSF files: record 
headers and control records are transferred). 


0 means do not compact; | (default value) means 
compress records for transmission. 


number of record to start from in INFILE after an 
incident in a previous file transfer request execution 
(first record is 1). 


if 1, restart transfer after interruption of a previous file 
transfer request execution. The restart point is 
automatically determined by the file transfer processor. 


specifies, if needed, the name of a user, other than the 
submitter, for whom the connection to the remote site 
is being requested. 


when submitting a request on behalf of another billing 
or project. 


specifies the password of the USER described above. 


if 1, request is initially held; the command 
RELEASE USER _ REQ can be subsequently used to 
release it. 


the class of the request, expressed as a letter in the 
range A to Z. 


the priority of the request, expressed as a number in 
the range 0 to 7. The lower the number, the higher the 
urgency. 


the symbolic name to be given to the request for 
further references in dedicated commands. When 
omitted, the request can only be referred to by its File 
transfer Occurrence Number (FON in the form 
Fnnnnnnn) returned as a result of this command. 
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WHEN 


EVERY 


WAIT 


RRESTART 


CREATE 


CATNOW 
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When the request is to be taken into account, 
expressed as: 


IMMED now; [mm.dd.[yy]yy]. hh.mm a date; 
+nnnnn{W D H M} a number of weeks, days, hours or 
minutes. 


When omitted, IMMED is assumed. 


For more information on the when-clause, refer to 
Appendix E WHEN, EVERY and RRESTART. 


The frequency and number of times the request is to be 
submitted, in the form: (frequency, number-of-times) It 
is two values separated by a comma. 


For more information, refer to Appendix E WHEN, 
EVERY and RRESTART. 


a list up to 8 request names (FON or JON). The current 
request is not executed until the WAIT requests have 
completed execution. In the case of the JON, the 
current request waits until completion of the issued 
JOB if executed locally, and until completion of the 
JCL file transfer if executed on a remote site. 


Specifies various possibilities for handling requests 
that were received while the system was off. 

For further information, consult Appendix E WHEN, 
EVERY and RRESTART. 


Creates the outfile, there are 3 possibilities: 


CREATE = NO: No creation, except for older releases 
under the OUTDEF parameter. 


CREATE = REPLACE: The existing output file is 
deallocated and a new file is created as specified. A 
warning message is issued. 


CREATE = KEEP: The existing file is kept. A warning 
is issued and any creation and allocation parameters 
are ignored. 


CREATE = NEW: An error is returned and file transfer 
aborts. 


indicates whether a file level catalog entry is to be 
created in the catalog; meaningful if CREATE is used. 
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EXPDATE 


DELETE 


TYPE 


INDEF/OUTDEF 


SHARE/ACCESS 


OUTALC 


DENSITY 
TRACE 
BRIEF 
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file expiration date expressed as: nnn (day in the year), 
[yylyy/ddd (year and day), or [yy]yy/mm/dd (year, 
month and day in the month). Default is no expiration 
date. 


Meaningful if CREATE is used. 


The subfile of the local site will be deleted at the 
normal end of the transfer. Confirmation of deletion 
will be asked if the CONFIRM parameter is available 
in the user profile. 


In the case of an infile from a foreign machine, and the 
existence of the CREATE option, this parameter gives 
the type for the library to be created on the DPS 7000. 


further processing options for the input and output files 
expressed as file-define parameter groups, as detailed 
in the JOF Terminal User's Reference Manual. 


sharing and access mode for local file(s) being 
handled. When omitted, default value for SHARE is 
NORMAL; default value for ACCESS is READ for 
INFILE and WRITE for OUTFILE. 


It is the allocation group for the out file and supplies 
supplementary information for the file to be created. It 
is only used with the CREATE option. For further 
information, refer to the UFT User Guide. 


This is the tape density. 
If 1, the RFA trace is displayed on the screen. 


If 1, only the messages issued at the beginning and at 
the end of the transfer are displayed. The default is 0. 


e Either INFILE or OUTFILE must refer to a local file 
e APPEND is exclusive of START and RESTART 

e START and RESTART are mutually exclusive 

e BRIEF and TRACE are mutually exclusive 


e Itis possible to mix file transfer and job requests, but it is not allowed to mix 
requests (JONs/FONs) and mames. WAIT=(F18,F25,J38) or WAIT=(A,B,C,D) 
is allowed, whereas WAIT=(F18,A,J38,B) is not allowed. 


7-161 


GCOS 7 System Operator's Guide 


e Chaining between requests is limited to 1 level. 
EFTR <...> NAME=REQ1 
EFTR <...> NAME=REQ2 WAIT=REQ1 is allowed 
EFTR <...> WAIT=REQ7? is rejected because REQ? is already waiting for 
REQI1. 


e OUTALC, CATNOW and EXPDATE are not allowed without CREATE or if 
CREATE = NO. 


Examples 


EFTR 


EFTR 


EFTR 


EFTR 


EFTR 


EFTR 


EFTR 


EFTR 
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PROJ.LIB1. .FLOC 

SSITE:LIB2..FREM 

NAME=FTRANS2 WAIT=FTRANS1 BINARY 
{transfer SSF subfile to remote file, on completion of 
request FTRANS1} 


SLYON: LIB. .FROM 
LOCLIB..FLOC RESTART WHEN=12.00 
{at 12.00 restart file transfer which previously failed} 


MYFILE1 SLYON:MYFILE3 NAME=REQ1 

MYFILE2 SLYON:MYFILE4 NAME=REQ2 WAIT=(REQ1) 
{first transfer MYFILE1 to MYFILE3 on $LYON site; 
when that is finished, transfer MYFILE2 to 
MYFILE4} 


SLYON: LIB. .FROM 

LOCLIB..FLOC APPEND BINARY 

COMPACT=0 NAME=FTRANS 
{start the transfer immediately, appending in an 
existing file} 


MYFILE SLYON:MYFILE2 WAIT=(F23,J67,F45) 
{Request the transfer of the MYFILE file to $LYON 
site; the transfer starts when preceding file transfer 
with FON=F23 and FON=F45, and job with JON=J67 
are terminated} 


MYFILE $LYON: EVERY=(2H, 3) ; 
{Transfer MYFILE to site $LYON, 3 times every 2 
hours. } 


LIB1.MB1 SSITE:LIB2..MB2 BINARY DELETE 
(Transfer MB1 subfile to remote site and delete it from 
LIB1 library.) 
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7.7.2. ENTER_JOB_REQ (EJR) (EJ) 


Purpose 


Requests the execution of one or more jobs or submits a jobset request. 


Syntax 
{ ENTER_JOB REQ } 
{ EJR 
{ EJ } 


[ MEMBERS = star62 ] 

PROC = name31 ] 

LIB = 11b78 ] 

CLASS = aa ] 

PRIORITY = {0 |1]2|]3]4|5 |6|7} 1] 
HOLDOUT = bool ] 

DEST = [name8.]names ] 

HOLD = bool ] 


SWITCHES = { ( dec2 [ dec2 ] ... ) | 32 } ] 
{ VALUES } 

} = ( value-expressions ) ] 
{ VL } 


USER = namel12 ] 

PROJECT = namel12 ] 

BILLING = namel2 ] 

REPEAT = bool ] 

HOST = names ] 

RHOLD = bool ] 

RCLASS = a ] 

RPRIORITY = {0 |1]2|3]4/5]6|7}1] 
NAME = names ] 


IMMED 
([mm.dd. [yy] yy]. hh.mm 


] 
] 


col 


+nnnn{W|D|H|M} 


{ 
{ 
WHEN = { 
{ 
{ when-clause 


We Wwe ee 
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col 


ol 
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{ W | WEEK } 
{ D | Day } 
{ H | HOUR } 
EVERY = ( [ decS5 ] { M | MIN } [ dec5 ] ) ] 
{ MONTH } 
{ WKD } 
{ NWKD } 
{ CANCEL | NO } 
{ IMMED } 
RRESTART = { }] 
{ delay } 
{ delayE } 
WAIT = ( name8 [ name8 ] ... ) ] 
JOBLANG = { JCL | GCL } ] 
DEBUG GCL = { bool | 0 } ] 
TRACE GCL = { bool | 0 } ] 
PRIFILE = file78 ] 
{ VALUES2 
{ = ( value-expressions ) ] 
{ vL2 
{ VALUES3 
{ = ( value-expressions ) ] 
{ VL3 
{ VALUES4 
{ = ( value-expressions ) ] 
{ vL4 
{ INFILE } 
{ } = rfile78 ] 
{ INF } 


STARTUP = bool ] 
{ HOLDCOUNT } 


{ } = 


{ HOLDCNT  } 
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Parameters 


MEMBERS 


PROC 


LIB 


CLASS 


PRIORITY 


HOLDOUT 
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DELETE = { NO | YES | FORCE } ] 

FROM = namel2 ] 

TO = namel2 ] 

BANINF ( char12 [ char12 [ charl2 [ char12 ] ] ] ) ] 
BANNER = bool ] 


[ LIST = { SOURCE | ALL | NO } ] 
[ JOR = { NORMAL | NO | ABORT } ] 
[sev={1]2/3]4]/5}1] 
[ ENVT = namel2 ] 

[ JOBNAME = names ] 


} 
{ } = { bool | 0 } ] 
{TR } 
BRIEF = { bool | 0 } ] 
EXPVAL = { bool | 0 } ] 


a star-name denoting the member(s) containing the 
job(s) to be submitted. 


the name of the GCL procedure to be submitted as an 
absentee job. 


the library containing the members or the procedure to 
be submitted. It must not be a temporary library. If the 
parameter is omitted, the default SL output library 
(#SLIB), for MEMBERS, or the current binary input 
search path (#BINLIB), for PROC, is assumed, unless 
it refers to temporary libraries. If #SLIB or #BINLIB 
is temporary or unassigned, a system default library is 
assumed. 


the class of the submitted jobs, expressed as one or two 
letters in the range A to RZ. 


the priority of the submitted jobs, expressed as a digit 
in the range 0 to 7. The lower the priority, the higher 
the urgency. 


if 1, jobs' outputs are to be held. The directive 
RELEASE OUTPUT can subsequently be used to 
release them. 
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DEST 


HOLD 


SWITCHES 


VALUES 


destination of output expressed as [host-name. | 
station-name. See JOF Terminal User's Reference 
Manual, Part 1. 


if 1, jobs are held. The directive RELEASE JOB can 
be used in order to make them eligible for execution. 


a list of the switches (expressed as numbers in the 
range 0 to 31) to be set in the submitted jobs. Value 32 
denotes that current values for the switches are passed. 


a list of one or more values, enclosed in parentheses, to 
be passed to the submitted job (MEMBERS), or 
denoting the parameters of the submitted absentee job 
(PROC). If the values exceed 254 characters, "hidden" 
parameters VALUES2, VALUES3, and VALUES4 
may be used. 


USER/PROJECT/BILLING 


REPEAT 


HOST 
RHOLD 


RCLASS 


RPRIORITY 


NAME 
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if submitting jobs on behalf of another user, project, or 
billing. 


if 1, repeat the job if it is cancelled or if there is a 
system failure or abort. 


the name of the host where the jobs are to execute. 


if 1, hold the jobset request. The directive 
RELEASE USER_ REQ can subsequently be used to 
release the request. 


the jobset request class, expressed as a letter in the 
range A to Z. 


the priority of the jobset request, expressed as a 
number in the range 0 to 7. The lower the number, the 
higher the urgency. 


the symbolic name to be given to the request for 
further references in dedicated directives. Names in 
the form Jnnnnnnn and Fnnnannn are not allowed. 
When omitted, the request may only be referred to by 
its Jobset Occurrence Number (JON in the form 
Jnnnnnnn) returned by this directive. 
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WHEN 


EVERY 


RRESTART 
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when the request is to be taken into account, expressed 
as: 


IMMED: now (default) 
Imm.dd.lyy]lyy]. hh.mm: a date 
+nnnnn{W|D|H|M}: a number of 


weeks, days, 

hours, minutes 
when-clause: a range of 

expressions 


The WHEN parameter offers a rich selection of 
options. For a detailed discussion, to Appendix E . 
When omitted, IMMED is assumed. 


the interval and number of times the request is to be 
executed, expressed as: 


(interval [ number-of-times ]) 


If number-of-times is omitted, an infinite number of 
times is assumed. Interval can be expressed as a 
number of weeks, days, hours, or minutes; month 
(MONTH), working days (WKD), or non-working 
days (NWKD). The minimum interval is defined by 
the CONFIG statement DJPCTL (default = 15 minutes, 
lowest is | minute). The maximum interval is 45 days, 
12 hours, and 15 minutes (65535 minutes). For a more 
detailed discussion, refer to the Help texts and 
Appendix E When, EVERY and RRESTART. 


specifies how an EFTR request should be handled, if 
the request is not executed because of a system failure 
or normal shutdown. Valid options are: 


IMMED request enqueued 
immediately. 
CANCEL/NO request is cancelled. 
delay delay added to normal 
enqueuing time. 
delayE elapsed delay, the 


maximum delay 
allowed for placing 
request in queue. 


For more detailed information, refer to the Help texts 
and Appendix E When, EVERY and RRESTART. 
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WAIT a list of up to 8 request names (FON, JON, or 
symbolic). The current request will not be executed 
until the WAIT requests have completed execution. In 
the case of the JON, the current request waits until 
completion of the issued job if executed locally, and 
until completion of the JCL file transfer if executed on 
a remote site. 


In the case of a local job request waiting for 
completion of another job, if the first job terminates 
with a severity greater than or equal to 3, the waiting 
request is cancelled. If the severity is less than 3, the 
request is released. 


JOBLANG command language used in the job description: 
GCL GCOS 7 Command Language 
JCL GCOS 7 Job Control Language 


The default value for the parameter JOBLANG is the 
value set in the system variable #JOBLANG of the 
user profile. The variable #JOBLANG has no default 
value. When JOBLANG is specified in EJR and in the 
statement $JOB, the value specified in $JOB overrides 
the value specified in EJR. 


DEBUG GCL if 1, debug GCL procedures. Each time a line is 
executed, it is displayed with evaluated variables 
prefixed by procedure name and line number. In batch, 
a missing procedure name is replaced by the RON. The 
default value is 0. This parameter may only be used 
when the job description language is GCL. 
DEBUG_GCL+=1 is equivalent to the directive 
MODIFY PROFILE DEBUG. 


TRACE GCL if 1, trace all CALL statements executed on the current 
output device. The default value is 0. This parameter 
may only be used when the job description language is 
GCL. TRACE_GCL=1 is equivalent to the directive 
MODIFY PROFILE TRACE. 


PRTFILE the report file, used when the job description language 
is GCL. If omitted (and if PRTFILE is not specified in 
the $OPTIONS statement), the report is directed to the 
standard system file SYS.OUT. 


The value specified for PRTFILE in EJR overrides the 
value specified in $OPTIONS. 
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VALUES2/VALUES3/VALUES4 


INFILE 


STARTUP 


HOLDCOUNT 


DELETE 


FROM/TO 


BANINF 


BANNER 
LIST 


SOURCE 


ALL 


may be used when the values exceed 254 characters 

(see parameter VALUES). VALUES2, VALUES3, and 
VALUES4, though "hidden parameters", appear on the 
menu directly after VALUES when "EJR+" is entered. 


the file or remote file containing the jobs to be 
submitted. 


if 0, do not execute the STARTUP sequences in the 
submitted jobs. 


the submitted jobs are held. They will be released only 
when the specified number of RELEASE JOB 
directives have been issued. 


if YES, delete the subfile after submission. If FORCE, 
the subfile is deleted, even if submission is 
unsuccessful. 


(with INFILE only) select the first and last jobs to be 
submitted in INFILE. Default values are the first job 
for FROM, and the last one for TO. 


up to four 12-character texts to appear on the output 
banner. The banner is built from bottom to top, with 
each succeeding line pushing up the previous one(s). 


if 0, no output banner is generated. 


permits the user to select the type of information to be 
printed when listing the JCL on the Job Occurrence 
Report. 


the source JCL or GCL, inserted Stream Reader 
statements, records inserted using a SSWINPUT 
statement with the CONSOLE parameter, and error 
messages are listed. 


the source JCL or GCL, records inserted using a 
$SWINPUT statement, and all expansions of JCL 
sequences which are entered using INVOKE, and 
project start-up are listed, along with error messages. 
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NO 


JOR 
NORMAL 


NO 
ABORT 


SEV 


ENVT 


JOBNAME 


TRACE 
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only Stream Reader statements, comments, and error 
messages are listed. 


If Access Rights have been implemented and the user 
does not have the READ right over the file(s) 
containing the information to be printed, then LIST is 
ignored. 


a Job Occurrence Report will be produced at the end of 
job execution. 


no Job Occurrence Report will be produced. 


a Job Occurrence Report will be produced when job 
execution aborts. For a GCL procedure submitted as an 
absentee job, the default value is ABORT. 


with PROC: defines the session severity level at which 
a GCL procedure submitted as an absentee job will be 
aborted at the end of the current step. The default value 
is 4. 


with JOBLANG=GCL: defines the severity level at 
which the batch job will be aborted at the end of the 
current step if DEFAULT is the current value for 
ON_ERROR. 


SEV is ignored when JOBLANG=JCL. 


(with PROC only) defines the alternate environment 
from which a GCL procedure submitted as an absentee 
job is accessible by the user's project. When omitted, 
the default environment of the user's project is 
assumed. 


(with PROC only) the symbolic name to be given to 
the absentee job. When omitted, the name ABSENTEE 
is assumed. 


if 1, the RFA (Remote File Access) trace is displayed 
on the screen. The default value is 0. 
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BRIEF if 1, only the messages issued at the beginning and end 
of the job execution are displayed when the parameter 
HOST is used. It is ignored if HOST is not used. The 
default value is 0. 


EXPVAL if 1, expansion of the values in the JCL of the job is 
required in the Job Occurrence Report. The default 
value is 0. 

Rules 


e BANNER=0 and BANINF are mutually exclusive. 
e Ajobset is created if: 
- INFILE is used and denotes a remote file 


- one of the following parameters is used: HOST, RHOLD, WHEN, EVERY, 
WAIT. 


e Either MEMBERS, PROC, or INFILE must be specified. 

e INFILE is exclusive of LIB, MEMBERS, PROC, and DELETE. 

e HOLD and HOLDCOUNT are mutually exclusive. 

e STARTUP has meaning only when MEMBERS is specified. 

e FROM and TO can only be used when INFILE is used. 

e ENVT and JOBNAME are meaningful only when PROC is used. 
e SEV is meaningful only when PROC or JOBLANG=GCL is used. 


e File transfer and job requests may be mixed, but the mixture of JONs/FONs and 
symbolic names is not allowed. WAIT=(F18,F25,J38) or WAIT=(A,B,C,D) is 
allowed; WAIT=(F18,A,J38,B) is not allowed. 


e Chaining between requests is limited to 1 level, for example: 
EJ MYJOB1 NAME=REQ1 
EJ MYJOB2 NAME=REQ2 WAIT=REQ1 is allowed 
EJ MYJOB3 WAIT=REQ?2 will be rejected because REQ? already waits on 
REQI1 


e If JOBLANG=GCL, EXPVAL and HOST must not be specified. 
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Examples 


EJR 


EJR 


EJR 


EJR 


EJR 
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PROC=LSV VALUES=MYV:MS/D500 
{submit absentee job to list a volume} 


MYJOBS CLASS=D 
{submit jobs in output library} 


JOBS LIB=PROJ.LIB 
{submit jobs within specified library} 


JOBS WAIT=(F18 F19) 
{submit after completion of two file transfer requests} 


MYJOB1 NAME=REQ1 WAIT=(F12,J67) 


{submit after completion of file transfer F12 and job 
J67} 


MYJOB2 WAIT=(A,B,C,D) 
{submit after completion of jobs or file transfers A, B, 
C, and D} 


PROC=MYPROC BINLIB=MYLIB.BIN ENVT=PREP 


{submit absentee job using alternate environment 
PREP} 


PROC=MYPROC BINLIB=MYLIB.BIN JOBNAME=MYPROC 
{submit absentee job with symbolic name MYPROC} 


JOBS LIB=PROJ.LIB HOST=LYON NAME=PAYROLL WAIT=(FP1 FP2) 
{execution on remote host, wait for two file transfer 
requests} 


INFILE=$LYON: P1.REMLIB..REMSF WHEN=+20H 
{submit jobs from remote file in 20 hours time} 


PROC=MYPROC VALUES= (A,B,C) 
{submit absentee job with specified values} 


Al A; LET Bl B; LET C1 C 
PROC=MYPROC VALUES=#CAT(%A1,',',%B1,',',%C1) 
{same as above with calculated values} 


MYJOB EVERY=(2H 3) 
{submit job MYJOB; execution every two hours and 
repeated three times} 
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7.7.3 ENTER_LIBTRANS_REQ (ELTR) 


Purpose 


A complete library or part of a library can be transferred with this command. The 
asterisk (*) used as a "wild card" is allowed. 


Syntax 


{ ENTER LIBTRANS REQ } 
{ ELTR 


INLIB = 11b44 
SUBFILE = ( star31 [ star31 ]... ) 


OUTLIB = char44 


[ SITE = name4 ] 


al 


BINARY = { bool | 1 } ] 


al 


COMPACT = { bool | 1 } ] 


cal 


STARTMB = char31 ] 


al 


ENDMB = cChar31 ] 


al 


CONCISE = { bool | 0 


— 
[o) 
Ww 
wu 


USER = namel2 ] 


coal 


PROJECT = namel2 ] 


load 


BILLING = namel2 ] 


coal 


PASSWORD = charl12 ] 


cal 


RHOLD = bool J 


coal 


RCLASS = namel ] 


cal 


RPRIORITY = {0 |1]2]3|]4|5|6|7}] 


coal 


NAME = names ] 
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coal 
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{ IMMED }] 
{ [mm.dd. lyylyy]. hh.mm }] 
WHEN = { }] 
{ +<dddd {w|]D|]H|mM} } ] 
{ when-clause }] 
{ W | WEEK 
{ D | DAY 
{ H | HOUR 
EVERY = ( [ dec5 ] { M | MIN [dec5] ) 
{ MONTH 
{ WKD 
{ NWKD 
WAIT = ( name8 [name8] ..) ] 
{ CANCEL | No } 
{ IMMED } 
RRESTART = { } 
{ delay } 
{ delayE } 
{ CREATE } ] 
} = { REPLACE | KEEP | NEW | NO } ] 
{ CR } ] 
CATNOW = bool ] 
EXPDATE = [yylyy.mm.dd ] 
DELETE = bool ] 
INDEF = (file-define-parameters) ] 
OUTDEF = (file-define-parameters) ] 
OUTALC = (file-allocation-parameters) ] 
{ TRACE } ] 
} = { bool | 0} ] 
{ TR } ] 
BRIEF = { bool | 1 } ] 
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Parameters 


INLIB 


SUBFILE 


OUTLIB 


SITE 
BINARY 


COMPACT 


STARTMB 


ENDMB 


CONCISE 


USER 


PROJECT 


BILLING 


Description of the Operator Commands (Part 1) 


name of the INLIB library. This is the library from 
which the information is read (transferred). 


name of the library members to be transferred or star 
convention; up to 10 subfiles can be listed. 


name of the output library. This is the library to which 
the information is to be written (transferred). 


A remote site can be specified with this parameter. 


If 1, binary format transferred (for SSF files: record 
headers and control records are transferred). 


0 means do not compact; | (default value) means 
compress records for transmission. 


Parameter used when transferring part of a library to 
specify, inside the star convention (*), the name of the 
first member to be transferred. 


Name of the last library member to transfer; it must be 
compatible with the star convention (*). 


Normally, when transferring part or all of a library, a 
message is sent to each transfer member. The 
CONCISE option enables these messages to be 
skipped, and in this case there is only one message 
giving the number of transferred members plus the 
complete number of records transferred. 


If needed, specifies the name of a user other than the 
submitter for whom a connection is to be made 
towards the remote site. If USER is given, a 
PASSWORD is also required. 


The project identification used by the server on the 
remote site for file access checking. 


The BILLING for the specified project. If the 
parameters PROJECT and BILLING are not specified, 
the submitter USER must be catalogued on the remote 
site with the same PROJECT/BILLING affected to 
him locally when the file transfer is submitted. 
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PASSWORD 


RHOLD 


RCLASS 


RPRIORITY 


NAME 


WHEN 


EVERY 
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Specifies the password of the user given by the USER 
parameter. Note, that now, a same user can be known 
on two sites with different passwords. 


If 1, request is initially held; the command 
RELEASE USER_REQ can be subsequently used to 
release it. 


The class of the request, expressed as a letter in the 
range A to Z. 


The priority of the request, expressed as a number in 
the range 0 to 7. The lower the number, the higher the 
urgency. 


The symbolic name to be given to the request for 
further references in dedicated commands. When 
omitted, the request can only be referred to by its File 
transfer Occurrence Number (FON in the form 
Fnnnnnnn) returned as a result of this command. 


when the request is to be taken into account, expressed 
as: 


IMMED now; [mm.dd.[yy]yy]. hh.mm a date; 
+nnnnn{W | D | H | M} a number of weeks, days, 
hours or minutes. 


When omitted, IMMED is assumed. 


For more information on the when-clause, refer to 
Appendix E When, EVERY and RRESTART. 


the frequency and number of times the request is to be 
submitted, in the form: (frequency, number-of-times) It 
is two values separated by a comma. 


For more information, refer to Appendix E When, 
EVERY and RRESTART. 
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WAIT A list up to 8 request names (FON or JON). The 
current request is not executed until the WAIT requests 
have completed execution. In the case of the JON, the 
current request waits until completion of the issued 
JOB if executed locally, and until completion of the 
JCL file transfer if executed on a remote site. 


RRESTART Specifies various possibilities for handling requests 
that were received while the system was off. 


For further information, consult Appendix E When, 
EVERY and RRESTART. 


CREATE Creates the outfile, there are 3 possibilities: 


CREATE = NO: No creation, except for older releases 
under the OUTDEF parameter. 


CREATE = REPLACE: The existing output file is 
deallocated and a new file is created as specified. A 
warning message is issued. 


CREATE = KEEP: The existing file is kept. A warning 
is issued and any creation and allocation parameters 
are ignored. 


CREATE = NEW: An error is returned and file transfer 
aborts. 


CATNOW Indicates whether a file level catalog entry is to be 
created in the catalog; meaningful if CREATE is used. 


EXPDATE File expiration date expressed as: nnn (day in the 
year), [yy] yy/ddd (year and day), or [yy]yy/mm/dd 
(year, month and day in the month). Default is no 
expiration date. Meaningful if CREATE is used. 


DELETE The subfile(s) of the local site will be deleted at the 
normal end of the transfer. Confirmation of deletion 
will be asked if the CONFIRM parameter is available 
in the user profile. 
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INDEF Since the input file is known, this parameter is only 
useful in certain special cases: 


1. When an input file does not have standard 
labels (tape or cassette only). 


2. When the logical input definition is ignored 
by the remote system having the input file 
(SPS7, SPS9, DPX, etc.) because these files 
are stored in stream format. 


3. When the input file is on the local DPS 
7000 site in order to change processing 
parameters such as: NBBUF, BPB. 


OUTDEF This parameter is used as follows: 


1. When it has not been preallocated (tape and 
cartridge only). 


2. When the output file is a preallocated file 
on a DPS8. (In this case, the parameters 
RECSIZE, RECFORM, BLOCKSIZE or 
CISIZE, and FILEFORM must be used. 
When the destination file is a GFRC file, 
the FILEORG is SEQ and the RECSIZE 
must not be greater than 1272. If the 
destination file is UFAS SEQ, the 
FILEORG to be given is RANDOM. 


3. Under the CREATE option, when the user 
would like to change the input file 
definition image used for preallocating the 
outfile. This is needed so that he can modify 
only the parameters that are not the same. 


NOTE: The parameters referred to above are defined 
in the JCL Reference Manual. 


OUTALC It is the allocation group for the out file and supplies 
supplementary information for the file to be created. It 
is only used with the CREATE option. For further 
information, refer to the UFT User Guide. 


TRACE If 1, the RFA trace is displayed on the screen. 


BRIEF If 1, only the messages issued at the beginning and at 
the end of the transfer are displayed. The default is 1. 
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Rules 

e The input library (INLIB) must be local and the output library (OUTLIB) must 
be remote. 

e INLIB may not be a temporary input library. 

e If CONCISE=1 is used, then SUBFILE=* must be used. 

e If STARTMB or ENDMB is used, then SUBFILE=* must be used. 


e OUTALC, CATNOW and EXPDATE are not allowed without CREATE or if 
CREATE = NO. 


e WAIT and RRESTART are mutually exclusive. 


Examples 


ELTR mylib a* yourlib LYON; 
{Transfer all members beginning with a from mylib to 
yourlib located on site LYON.} 


ELTR mylib a* yourlib LYON startmb=ap endmb=as; 
{This is the same as the preceding example except that 
the transfer begins with member ap and finishes with 
member as included. } 


ELTR mylib (a,b,c,d) yourlib LYON; 
{This is the same as the first example, except that only 
the named members, "a, b, c, and d" are transferred. } 


ELTR mylib a* yourlib LYON EVERY= (2H, 3) ; 
{Transfer all members beginning with a from mylib to 
yourlib located on site LYON, 3 times every 2 hours. } 


ELTR LIB1 MB1* LIB2 SITE DELETE 
(Transfer all subfiles matching the star convention to a 
remote site and delete them from the LIB] library.) 
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7.7.4 
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EXEC_CLS_COMMAND (EXCLS) 


Purpose 


Enters a Cartridge Library Server (CLS) command at the GCOS 7 main console. 


NOTE: 


The syntax and the description of the CLS commands can be found in the 


Cartridge Tape Library Operator's Guide. 


Syntax 


{ EXEC_CLS COMMAND } 
{ } 
{ EXCLS } 


{ COMMAND } 
} = char255 


{ CMD } 
[ { VALUES } ] 
[ { } = char255 ] 
[ { vb } ] 
Parameters 
COMMAND The character string is processed as a CLS command 
submitted by the CLC to the CLS. It must represent a 
valid CLS command name. 
VALUES 


be passed to the submitted command. 


The character string is processed as the parameters to 
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Rules 


e Ifthe command is entered in line mode and more than one parameter is specified 
in VALUES, the sequence of parameters must be enclosed in single quotes. 


e EXECUTE _CLS_COMMAND is rejected during the CLC initialization phase. 


Examples 
EXCLS ENTER {Enter cartridges through the CAP. } 
EXCLS DRAIN 000 {Terminates the operation initiated by ENTER} 


EXCLS DISPLAY 'V 001780 DET' 


{Displays detailed information concerning cartridge 
001780.} 
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7.7.5 EXEC_CLX_VOLRPT (VOLRPT) 


Purpose 


Activates the volrpt (volume report) utility on the UNIX server. This utility gives 
the list of volumes and their physical location in the library. It also provides history 
and usage statistics on these volumes. 


Syntax 


{ EXEC_CLX VOLRPT } 
{ VOLRPT } 


SERVER = <DPX/20 server name> 
RPTFILE = 1 | 0 


OPTIONS = <options value>. 


Parameters 

SERVER The name of the UNIX server on which the report is 
to run. 

RPTFILE If set to 1, the report is stored in the file 
/home/ACSSS/log/volrpt .log on the Unix 
server, if set to 0, the report is displayed on the console 

OPTIONS Refer to ACSLS Administrator's guide. 
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Rules 


e The OPEN 7 network name must be declared in the /home/ACSSS/rhosts file on 
the library server. It must contain the following line in which the DPS 7000 
name must be in lower case: 


<dps7000 name> clx 
e Permission bits for the file /home/ACSSS/rhosts must be -rw-r--r- 
e These conditions must have been fulfilled at the installation of CLX. 


Example 


VOLRPT RPTFILE=1 
SERVER='wolf'! 


The volume report is stored in the UNIX server file /home/ACSSS/log/volrpt.log. 
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7.7.6 EXECUTE_DIRECTIVE (EXDIR) 


Purpose 


Executes the commands (in GCL format) that are given in the COMMAND 
parameter. Main Operator commands may be submitted this way if the 
ABSENTEE Job is running under a project that has the "MAIN" attribute. When it 
is not the case, only IOF directives as described in the JOF Terminal User's 
Reference Manual may be executed. The image of the submitted commands and 
the error-messages (if any) is provided in the JOR. 


{ EXECUTE DIRECTIVE } 
{ EXDIR } 


COMMAND = char255 


Parameters 

COMMAND the string of commands to be executed (commands are 
separated by a semi-colon). 

Rules 


e The GCL directives 'MWINLIB BIN' and 'BYE' may not be executed via 
EXDIR. 


e A job cannot suspend itself through HJ via EXDIR unless the ENDSTEP 
parameter is used in the HJ command. 


Example: 


EXDIR 'MODIFY LOAD MULTI=100 CLASS=P ; MDHW TWIN=0'; 
{set multiprogramming level for P class to 100 and 
reinsert all available resources in the CSS} 
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"F" and "G" Commands 


FORCE_JOB (FJ) 


Purpose 


Positions a job at the front of the queue for job scheduling, ignoring any restriction 
due to the job class or the fact that the job is in the HOLD state. The named job 
starts as soon as it can, regardless of whether its class is started or not. The job 
starts even if its class or the system becomes overloaded or even if it is in the 
HOLD state. A forced job can be held before it is started by using the HOLD JOB 
command, in which case it is no longer considered as being forced. 


Syntax 


{ FORCE JOB } 
{ Fd } 


RON = Xnnnn 


[ { SYSTEM } ] 
[ { } = name4 ] 
[ { sys } ] 
Parameters 
RON the Run Occurrence Number (RON) of the job to be 
forced. 
SYSTEM This parameter indicates the system where the 


command will be executed. 
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Rules 


e FORCE_JOB cannot apply to service jobs or to jobs that are in the OUT state. 


e Only one forced job may be present in the IN state at any one time. If there is a 
forced job waiting to start and another FORCE_JOB command is issued for 
another job, the first job returns to its original position in the scheduling queue 
and is no longer considered as being forced. 


e A forced job does not start if the maximum J number is exceeded. 


Example 


FJ X1234 {force job with RON X1234} 
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7.8.2 FORCE_OUTPUT (FO) 
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Purpose 


Forces an output. The output is started as soon as an output device of the correct 
type becomes available. If a forced output was held, it is released. 


Syntax 


{ FORCE OUTPUT } 
{ FO } 


OUTPUT = output14 


[ STRONG = bool ] 


Parameters 

OUTPUT the name of the output to be forced. It may take one or 
the two following forms: 
Xnnnn:nnnn 
Xnnnn:name 

STRONG if 1, the output is forced even if the output is in the 
READY state. 

Rules 


Only one output may be forced on a station at any one time. Any subsequent 
FORCE OUTPUT command on a given station is rejected, until the forced output 
is held, or until it no longer exists in the queue of a station. The operator must 
either wait until the previous forced output is completed, or else cancel it, or hold 
it, or transfer it to another station before trying again. 


Examples 
FO X1234:2 {force the named output} 
FO X1234:REPORT {force the output of job X1234 named REPORT} 


FO X45:3 STRONG {force the specified output even if in the READY 
state} 
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7.8.3 FORCE_SERVER_TIMEOUT (FSVRTO) 


Purpose 


Ifa SERVER aborts without notifying CMSR, the SERVER will be forcefully 
terminated when CMSR has not heard from it for a certain period of time. This 
command enables the operator to reduce this waiting time. 


The operator must use this command with caution, because it can terminate the 
SERVICE on the current MEMBER. 


Syntax 
{ FORCE _SERVER_TIMEOUT } 
{ FSVRTO } 
{ SERVICE } 
{ } = name8 
{ SRV } 
Parameters 
SERVICE Name of the SERVICE 
Rules 


e The CMSR of the MEMBER on which this command is entered must be 
running. 


e The SERVICE must be the COMPLEX description. 


e The CMSR of the current MEMBER must be waiting for a notification of this 
SERVICE. 


Examples 


FSVRTO SRV=TDS1 {Forces the timeout for the SERVICE named TDS1 on 
the current MEMBER. } 
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7.8.4 | FORCE_USER_REQUEST (FUR) 


Purpose 


Forces a request. The WHEN and/or WAIT conditions (if any) are ignored and the 
request is put in queue in the WAIT state with the highest priority. 


Syntax 


{ FORCE_USER_REQ } 
{ FUR 


REQUEST=name8 


Parameters 


REQUEST name of the request to be forced. It may take one of the 
following three forms: 


nnnnn: a Jobset Occurrence Number (JON), 
Fnnnnnnn: a File transfer Occurrence Number (FON), 
name8: the symbolic name of a request as specified by 
the NAME parameter of the ENTER JOB REQ or 
ENTER _FILETRANS REQ commands. 


RONSs and FONs are provided as results of the 
ENTER JOB REQ or ENTER_FILETRANS REQ 
commands. 
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Rules 


e Ifasecond FORCE USER REQ command is issued while the first forced 
request is not yet executed, the second request replaces the first one which is 
again given its initial priority. 


e FORCE USER REQ (J41 J48) does not work, because the command only takes 
one job at a time. 


Examples 

FUR F1234 {force a file transfer request} 
FUR J456 {force a jobset request} 

FUR MYREQ {force a named request} 
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7.8.5 GET_CLX_FILE (GTCLXF) 


Purpose 


Transfers a UNIX file to a local GCOS 7 file. The UNIX file can be located on the 
DPX/20 server or on OPEN 7. 


For example, this command can be used to transfer SSI or ACSLS log files to 
GCOS 7. 


Syntax 


{ GET_CLX_FILE } 
{ GTCLXF } 


SERVER = <server name> ! OPEN7 = 1 
REMOTE FILE = <dpx/20 or OPEN7 file name> 
GCOS _LIB = <GCOS 7-library-name> 


GCOS _SUBFILE = <GCOS 7-subfile-name> 


Parameters 

SERVER The name of the UNIX server that contains the file to 
be transferred. It is mutually exclusive with the 
parameter OPEN 7. 

OPEN7 Must be set to 1 if the file to be transferred is a local 
OPEN 7 file. If set to 1, the SERVER parameter must 
contain blank characters. 

REMOTE _FILE Name of the file to be transferred. 

GCOS_LIB Name of the GCOS 7 library into which the file is 
transferred. 

GCOS_SUBFILE Name of the GCOS 7 subfile into which the file is 
transferred. 
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Rules 


e Only files readable by the user <clx> can be transferred: permission bits must be 
set for the user <clx>. 


e UNIX server files can be transferred if the OPEN 7 network name is declared in 
the /home/ACSSS/rhosts file on the library server. 


e This condition must have been fulfilled at the installation of CLX. 


Example 


GTCLXF 
GCOS_LIB= lciu.cmd.sllib 
GCOS _SUBFILE=es volrpt_wolf 
REMOTE FILE='/home/ACSSS/log/volrpt .log! 
SERVER='wolf' 


The content of the /home/ACSSS/log/volrpt.log file of the library server <wolf> is 
transferred into the subfile es_volrpt_wolf in the GCOS 7 library Icitu.cmd.sllib. 
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(Part 2) 


Chapter 8 is the continuation of the detailed description of the GCL commands 
listed alphabetically. 


8.1 "H" and "I" Commands 


8.1.1. HOLD GCL_CACHE (HGC) 
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Purpose 


This command stops the operation of the GCL cache function and makes 
swappable the segments used by the cache function. The segments in question are 
those which are RESIDENT when the cache function is operational. 


{ HOLD GCL CACHE } 
{ HGC 


Parameters 


None. 


Rules 


None. 
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8.1.2 HOLD _JOB (HJ) 


Purpose 


Prevents execution of one or more jobs in the scheduling queue and puts executing 
jobs in the SUSPENDED state at the end of their current step if the parameter 
ENDSTEP is set to 1. Ajob may be held by its submitter, its USER and by main or 
station operators. The effect of the HOLD JOB directive may be reversed by 


means of the RELEASE JOB directive. 


Syntax 

{HOLD JOB} 

{HJ } 
[RONS = 
[{SELECT} 
{ 

[{SEL  } 
[ 

[ENDSTEP 
[ 

[STATION 
[{SYSTEM} 
{ } 
[{sys } 

Parameters 

RONS 

SELECT 

ENDSTEP 


(Xdddd [Xdddd] 


| 

{jclass}[ {usernm} 
{ EY 4 
eee of 


(en ee ee! 
~~ 


st-name] 


] 
name4] 


] 


a list of up to 16 Run Occurrence Numbers (RONs) 
identifying the jobs to be held or suspended. 


applies the command to the jobs that belong to the 
specified combination of class/user-name/project. (* is 


all jobs accessible by terminal-user). 


if 1, executing jobs are suspended at the end of their 
current steps. If 0 (default value) or not specified, 
executing jobs are immediately suspended. This 
parameter is ignored for jobs in the scheduling queue. 


STATION 


SYSTEM 


Rules 
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name of station where job must be held. 


This parameter indicates the system where the 
command is executed. 


e Service jobs may be neither held nor suspended. 


e Jobs in the OUT state may not be held nor suspended. 


e When used on a forced job, the job is considered as being held and no longer 
forced. 


e This command does not apply to the user jobs that use the GAC facility (General 
Access Control). 


e RONS and SELECT are mutually exclusive. 


e When no RONS are specified, all jobs matching the SELECT combination, 
which are not executing, are held. If ENDSTEP is set to 1, all executing jobs 
matching the SELECT combination are also suspended. 


e A job cannot suspend itself through HJ via EXDIR unless the ENDSTEP 
parameter is used in the HJ command. 


Examples 


HJ 


HJ 


HJ 


HJ 


HJ 


HJ 


HJ 
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ENDSTEP 


(X123 X456) 
X1234 ENDSTEP 
SL=AA 
SL=* /* /MYPROJ 


X123 ENDSTEP 


{hold all jobs not executing} 


{hold all jobs not executing and suspend the executing 
ones at the end of their current steps} 


{hold or suspend the two named jobs} 

{suspend job X1234 at the end of its current step} 
{hold or suspend all AA class jobs} 

{hold or suspend all jobs from project MYPROJ} 


{hold job X123 at the end of its current step if it is 
executing, or hold job X123 if it is in scheduling 
queue} 


8-3 


GCOS 7 System Operator's Guide 


8.1.3 


HOLD_OUTPUT (HO) 


J) 


Purpose 


Prevents the printing of outputs in queue, or suspends the printing of outputs being 
printed. The effect of HOLD OUTPUT may be reversed by means of the 
RELEASE OUTPUT command. 


IMPORTANT: 
This command applies only to the outputs on which the submitter has access 
rights 


Syntax 

{ HOLD OUTPUT } 

{ HO } 
[ { (outputl4 [ output14 ] ...) } ] 
[ OUTPUT = { outputl4-outputl14 }] 
[ {* | ALL } 


[ SELCLASS = a [-a] ] 
[ STRONG = { bool | 0 } ] 


STATION } { * 


{ 

{ 
[ { st } { names ] 
[ { SELECT } { user/project } ] 
[ { } = { */project }] 
Ea Ee eee }] 
LASER of} oS }] 
[ { JOBNAME } ] 
[ { } = name8 ] 
[ { JNM } ] 
[ { SYSTEM } ] 
bot } = name4 ] 
[ { sys } ] 
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Parameters 


OUTPUT 


SELCLASS 


STRONG 
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Outputs(s) to be held or suspended. The following 
formats are allowed. 


1. a list of the names of up to 16 outputs: 


- Xnnnn:nnnnn} to refer to a specific output 
} (Xnnnn:name means the first 
output 
- Xnnnn:name } so named) 


- Xnnnn to refer to all outputs of a job. 


2. a range of outputs delimited by a lower and an upper 
boundary. This may take the following form only: 


- Xnnnn-Xnnnn to refer to all outputs of a range 
of jobs. The first ron must be lower than the second 
one. 


3. to refer to all outputs of all jobs, specify: 


- * or ALL (default when JOBNAME is 
specified) 


(meaningful only for output names in the form Xnnnn) 
restricts the scope of the command to those outputs 
that belong to a certain class or range of classes. This 
may be expressed as: 


class for a single class 
class-class for a range of classes 


where class is a letter in the range A to Z. 


When SELCLASS is omitted, all existing or future 
outputs of the job are selected. 


NOTE: when no parameter follows the Run 
Occurrence Number (Xnnnn), all present and future 
outputs for the job are held. When a parameter follows 
Xnnnn, only currently known outputs for this specified 
job or job class(es) are held 


if 1, the outputs are suspended even if they are being 
printed. The default value is 0. 


8-5 


GCOS 7 System Operator's Guide 


8-6 


STATION restricts the scope of the command to outputs attached 
to the station specified. When omitted or when * or 
ALL is specified, there is no station restriction. 


SELECT restricts the scope of the command to outputs 
belonging to a specified user and/or project. Not 
meaningful when OUTPUT specifies a list of outputs 
(format 1). By default, only the outputs belonging to 
the command submitter are selected. 


JOBNAME restricts the scope of the command to the outputs of 
jobs with the name specified. If JOBNAME is 
specified, the default value for OUTPUT is *. 


SYSTEM indicates the system on which the command is to be 
executed. 


Rules 


e SELCLASS is ignored for names of specific outputs (Xnnnn:nnnn or 
Xnnnn:name). When using SELCLASS=A-2Z, only currently existing outputs are 
concerned. 


e Ifseveral outputs of the same job are given the same name, HO Xnnnn:name 
only affects the first output with that name encountered. 


e If JOBNAME is used, the only allowable values for OUTPUT are "*", "ALL", 
"Xnnnn-Xnnnn" or unspecified. 


Examples 

HO X234 {hold all outputs of job X234} 

HO X234 P {hold all outputs of job X234 that are of class P} 

HO X234 C-Q {hold all outputs of job X234 that are of classes C 
to Q} 

HO X234 :1 {hold specified outputs of job X234} 

HO X234:RESULT {hold specified outputs of job X234} 


HO (X234:2 X234:PH6) 
{hold specified outputs of job X234} 


HO X234 STRONG {hold all outputs of X234, even if being printed} 
HO X234 A-Z {hold all currently known outputs of job X234} 
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HO 


HO 


HO 


HO 


HO 


HO 
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X123-X2167 {hold all outputs, belonging to the command submitter, 
of the jobs whose RON is in the range X123 
to X2167} 

* SELCLASS=Z {hold all class Z outputs, belonging to the command 
submitter, of all jobs} 

* SELECT=U1/P1_ {hold all the outputs belonging to user U1 of project 


Pl} 


* STATION=BC10 {hold all outputs, belonging to the command submitter, 
that are attached to the station BC10} 


X123-X2167 SELCLASS=A ST=BC10 SEL=U1/P1 
{hold all class A outputs of jobs in the range X123 to 
X2167 that are attached to station BC10 and belong to 
user U1 of project P1} 


JOBNAME=JOB1 {hold all outputs, belonging to the command submitter, 
of the jobs named JOB1} 
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8.1.4 
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HOLD_TERMINAL_OUTPUT (HTO) 


Purpose 


Prevents the printing of outputs by the Generalized Terminal Writer, or suspends 
the printing of outputs being printed by the Generalized Terminal Writer. The effect 
of HOLD_TERMINAL OUTPUT may be reversed by means of the RELEASE 
_TERMINAL OUTPUT command. Refer to the Generalized Terminal Writer User 
Guide for a complete description of the Generalized Terminal Writer. 


Syntax 
{ HOLD TERMINAL OUTPUT } 
{ HTO 
OUTPUT = (Rnnnn [Rnnnn] ...) 
[STRONG = { bool | 0 } ] 
Parameters 
OUTPUT a list of the names of up to 16 outputs to be held. Each 
output name has the form Rnnnn and is provided as the 
result of the DPRINT command (with parameter 
TWDEST). 
STRONG if 1, hold even if outputs are being printed (in that 
case, the outputs become "frozen"). 
Rules 
None. 
Examples 
HTO R1234 {hold output with name R1234} 


HTO (R1234 R1235) {hold two outputs} 


HTO R1234 STRONG {hold even if being printed} 
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8.1.5 _HOLD_USER_REQ (HUR) 
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Purpose 


Prevents file transfer or jobset requests submitted by the terminal user from being 
executed. The effect of the HOLD USER REQ command is reversed by means of 
the RELEASE USER REQ (RUR) command. 


Syntax 
{ HOLD USER_REQ } 
{ HUR 
REQUEST = (name8 [names] ...) 
Parameters 
REQUEST a list of up to 16 names of requests to be cancelled. 

Each name may take one of the following three forms: 

— Jnnnnnnn a Jobset Occurrence No. (JON) 

— Fnnnnnnn a File transfer Occurrence No. (FON), 

— name8 the symbolic name of a request, as specified 
by the NAME parameter of the ENTER JOB REQ 
or ENTER_FILE -TRANS_ REQ commands. 

JONs and FONs are provided for the 

ENTER JOB REQ and ENTER FILETRANS REQ 

commands. They are unique identifiers for these 

requests. 
Rules 
None. 
Examples 
HUR F128 {hold a file transfer request} 
HUR J44 {hold a jobset request} 
HUR (F3 HOR J2) {hold three requests} 
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8.1.6 INIT_SYSTEM_TRACE (ISYSTR) 


Purpose 


Restores system trace domain attributes and connections to initial state values. 
Initial state values are defined as follows: 


e Before the first system trace collector execution, they are the values defined at 
GCOS 7 initialization. 


e During system trace collector execution, they are the values defined by system 
trace collector execution commands. 


NoTE: 
This command is to be used only under the direction of a Bull support engineer. 


Syntax 
{ INIT SYSTEM TRACE } 
{ ISYSTR } 
[ { DOMAIN} {ALL =} 1] 
[{ DM }={ }] 
[ { Too } { name64 } ] 
Parameters 
DOMAIN It is the name of a system trace domain, or if ALL (the 
default), all domains. 
Rules 
None. 
Example 
ISYSTR (Restore all trace domains to initial state status.) 
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8.2 "L" Commands 


8.2.1 LIST_DUMP (LSDP) 
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Purpose 


Lists all binary dumps for the selected RON (Run Occurrence Number), or for all 
dumps of SYS.SPDUMP. For further information, refer to Appendix B Calling 
System Utilities. 


Syntax 

{ LIST_DUMP } 
{ } 
{ LSDP } 


[ RON = { Xnnnn | ALL | * } ] 


Parameters 

RON the Run Occurrence Number of the job whose dumps 
are to be listed. If ALL (the default) or "*" is specified, 
all dumps of SYS.SPDUMP are listed. 

The following message is displayed for each dump that 
fits the selection criteria: 

DPO1 <dumpid> PGID=<jjjj> <lmname> <date> 
where "dumpid" is the dump identification (RON, 
dynamic step number, and number of the dump in the 
step); "jjjj" is the process-group identifier; "Imname" is 
the name of the load module (first 16 characters only); 
and "date" is the date and time of dump creation. 

Constraints 

None. 

Examples 

LSDP X2345 {list all dumps of job X2345} 
LSDP * {list all dumps of SYS.SPDUMP} 
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8.2.2 LIST_FILTER (LSFLT) 


Purpose 


List a single filter, a set of filters, or all filters that belong to the operator. 


Syntax 


{ LIST_FILTER } 
{ LSFLT } 


{ FILTERSET } 


{ 


{ FLTST 

[{ FILTER } 
C{ 

[{ FLT } 
[ { SYSTEM } 
ee 

[ { sys } 


Parameters 


FILTERSET 


FILTER 


SYSTEM 


8-12 


{o% } 
{ fltst } 
] 
] 
] 
name4 ] 


When used alone (without FILTER), specifies filter set 
to be listed (* means all operator defined filter sets). 
When used with FILTER, specifies the filter set to 
which the filter to be listed belongs. 


the name of the filter to be listed. When omitted, all 
filters that belong to the set of filters named by 
FILTERSET are listed. 


The system where the command is executed. 
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Rules 


When FILTERSET is *, FILTER cannot be specified. 


Examples 

LSFLT Al A101 {list filter A101 within filter set Al} 

FSFLT Al {list all filters of set Al} 

LSFLT * {list all filters and filter sets belonging to the operator} 
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8.3 "M" Commands 


8.3.1 MAIL 


Purpose 


Controls the flow of messages from the user's mailbox to his terminal. 


Syntax 
MAIL 
{ DISPLAY  }] 
{ ON }] 
ACTION = { OFF }] 
{ CLEAR }] 
{ }] 
{ALL }] 
OPTION = {Xnnnn }] 
{name8 [/Xnnnn] }] 
{ o }] 
SYNC = { }] 
1 }] 
Parameters 
ACTION Indicates what control is to be applied as follows: 


DISPLAY,D Print the contents of the mailbox. 


— ON Incoming messages are printed as they arrive. 


— OFF Incoming messages are held in the mailbox. 


CLEAR,C Delete messages in the mailbox as 
indicated by OPTION. 
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OPTION 


SYNC 
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If ACTION is CLEAR, indicates which messages are 
to be deleted as follows: 


— ALLAII messages are deleted (default value). 


— Xnnnn: Provides the Ron Occurrence Number of the 
originator of the messages to be deleted. 


— names: It is the name of the site from which all 
originated messages are to be deleted. 


— name8/Xnnnn Provides the site and the Run 
Occurrence of the originator of the messages to be 
deleted. 


In the synchronous response mode, the operator waits 
for the response before entering anything else at the 
keyboard. In asynchronous mode, the operator has 
control right away without waiting for the response. 
The SYNC parameter is used to change the response 
mode: 


SYNC = | gives Synchronous responses 
SYNC = 0 gives Asynchronous responses 


There is no default. Each new connection uses the 
mode previously set. At GCOS 7 initialization, the 
mode is set to synchronous. 
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Rules 


OPTION may be specified only if ACTION is CLEAR or C. 


Examples 
MAIL 

MATL ON 
MAIL OFF 
MAIL CLEAR 


MATL CLEAR X123 


MAIL SYNC 
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{print contents of mailbox} 
{accept mail} 

{do not accept mail} 

{clear the mailbox} 


{delete messages originating from job X123} 


MAIL CLEAR LYON/X123 


{delete messages originating from remote site job 
X123} 


{ask for a synchronous display of commands 
responses} 


47 A2 53US 


8.3.2 MODIFY_CLC (MDCLC) 
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Purpose 
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Modifies the Cartridge Library Client (CLC) parameters. 


Syntax 


{ MODIFY CLC } 
{ MDCLC } 


TRACE = { bool | 0 } 


CLEAR 


Il 
a 
oy 
[e) 
oO 
H 


Parameters 


TRACE 


CLEAR 


Rules 


If 1, the contents of the protocol messages exchanged 
between the CLC and the Cartridge Library Server 
(CLS) is displayed on the console. 


If 1, the content of the file SYS.CLC is cleared. 
If 0, the content is not modified. 
The default value is 0. 


CLEAR=! deletes all members of the library whose 
names begin with XMIT (explicit file transfer). 


MODIFY CLC is accepted even during the CLC initialization. The TRACE 
parameter can be used either for debugging purposes or during the installation 


phase. 


Examples 
MDCLC TRACE 
MDCLC 


MDCLC NTRACE 


MDCLC CLEAR 


{Enter trace mode.} 
{Exit trace mode, i.e. return to normal mode. } 
{Exit trace mode, 1.e. return to normal mode. } 


{Clear the content of the SYS.CLC library without 
modifying the current trace mode. } 
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8.3.3 MODIFY_CLX (MDCLX) 


Purpose 


Turns the CLX trace on or off. When the CLX trace is active, all messages 
exchanged between the CLX and the ACSLS are displayed on the operator terminal 
from which CLX was started. 


The trace displays requests sent to the ACSLS by CLX, and also displays the 
acknowledgements and responses returned by the ACSLS. 


Syntax 


{ MODIFY _CLX } 
{ MDCLX } 


TRACE = { 0 | 1 } 


Parameters 

TRACE If 1 (default), starts CLX trace mode 
If 0, stops CLX trace mode. 

Rules 


The command MDCLX TRACE can be used to verify that everything is 
functioning correctly during the installation phase, in order to determine the cause 
of a mount/dismount problem, or to understand a problem related to the exchange 
protocol between the CLX and the ACSLM. 


Example 


Trace of a FILSAVE utility. It begins with a request to mount the volume 001863 
on the device CT17 and terminates with the request to dismount this volume. 


S: MDCLX TRACE 

14.38 V2.1 TU14 CLX COMMAND IN PROGRESS 

14.39 X1865 IN FILSAVE USER=OPERATOR CLASS=P SPR=6 STATION=BCA9 

14.39 X1865 STARTED FILSAVE OPERATOR P 

* 14.39 CT17 MOUNT 001863 LIB FOR X1865 

LOCK DRIVE SEQ NO= 76 LOCKID= 0 USERID=BCA9 DRIVEID=0,0,1,2 WAIT=0 COUNT= 1 
STATUS= 0 

LOCK DRIVE SEQ NO= 76 REP TYPE=FINAL STATUS= 0 LOCKID=12136 DRIVEID=0,0,1,2 
STATUS 2= 0 TYPE=17 IDENT= 
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LOCK VOLUME SEQ NO= 77 LOCKID=12136 USERID=BCA9 VOLID=001863 WAIT=0 COUNT= 1 
STATUS= 0 
LOCK VOLUME SEQ NO= 77 REP TYPE=FINAL STATUS= 0 LOCKID=12136 VOLID=001863 
STATUS 2= 0 TYPE=17 IDENT= 
MOUNT SEQ NO= 78 LOCKID=12136 VOLID=001863 DRIVEID=0,0,1,2 READONLY=0 STATUS= 0 
--- SEQ NO= 78 REP TYPE=ACK REQID= 9002 
JB08 X1865.1 STEP H UTILITY XPR=8 PGID=22 
MOUNT SEQ NO= 78 REP TYPE=FINAL STATUS= 0 VOLID=001863 DRIVEID=0,0,1,2 
TU11 V2.1 CT17 IN LIBRARY : 001863 MOUNTED 
* DW10 CT17 DISMOUNT 001863 S 
DISMOUNT SEQ NO= 79 LOCKID=12136 VOLID=001863 DRIVEID=0,0,1,2 FORCE=0 STATUS= 0 
14.40 X1865.1 COMPLETED FILSAVE OPERATOR P 
--- SEQ NO= 79 REP TYPE=ACK REQID= 9004 
DISMOUNT SEQ NO= 79 REP TYPE=FINAL STATUS= 0 VOLID=001863 DRIVEID=0,0,1,2 
TU12 V2.1 CT17 IN LIBRARY : 001863 DISMOUNTED 

UNLOCK VOLUME SEQ NO= 80 LOCKID=12136 VOLID=001863 COUNT= 1 STATUS= 0 UNLOCK 
VOLUME SEQ NO= 80 REP TYPE=FINAL STATUS= 0 COUNT= 1 VOLID=001863 STATUS 2= 0 
TYPE=17 IDENT= 

UNLOCK DRIVE SEQ NO= 81 LOCKID=12136 DRIVEID=0012 COUNT= 1 STATUS= 0 

UNLOCK DRIVE SEQ NO= 81 REP TYPE=FINAL STATUS= 0 COUNT= 1 DRIVEID=0,0,1,2 
STATUS 2= 0 TYPE=17 IDENT= 

--- SEQ NO= 81 REP TYPE=ACK REQID= 9006 


The GCOS 7 mount request causes the following ACSLS requests: 


e lock drive, 
e lock volume, 
e mount. 


The GCOS 7 dismount request causes the following ACSLS requests: 


e dismount, 
e unlock volume, 
e unlock drive. 


The request <lock drive> is sent with the parameter LOCKID set to 0, where 0 
means no LOCKID, this ask ACSLS for a LOCKID in return. The returned 
LOCKID value is used by the CLX for the commands <lock volume>, <mount>, 
<dismount>, <unlock drive> and <unlock volume>. 


47 A2 53US 8-19 


GCOS 7 System Operator's Guide 


8.3.4 MODIFY_CONFIGURATION (MDC) - STATION OPERATOR 


Purpose 


Modifies the default output priority, the default output media, and the quota of lines 
for an output class. 


Syntax 
{ MODIFY CONFIGURATION } 
{ MDC } 
{ OUTCLASS 
{ = (a [a] ...) 
{OE 
[{ PRIORITY ] 
[{ = { 0]1/2/3|4|5]6|7 } 1 
[{ PRTY ] 
[{ MEDIA } ] 
[{ } = nameé ] 
[{ MD } ] 
LINES = { * | char7 } ] 


Parameters 

OUTCLASS a list of up to 10 output classes whose characteristics 
are to be modified. Each class is expressed as a letter 
(A through Z). 

PRIORITY the new default output priority for the output class, 
expressed as a digit in the range 0 through 7. 

MEDIA the new default output media for the output class. 

LINES Specifies the maximum number of lines for an output 


in the given class. If * or 9999999 is specified, there 
is no limit. If this parameter is omitted, the current 
value is kept. 


The value of LINES must be greater than 0. Any job 
that creates outputs for the class concerned with more 
than the number of lines permitted by the LINES 
parameter is aborted with return code ERLMOV. 
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The limit set by LINES does not concern dumps. 


Any buffering done by the OUTPUT-WRITER is not 
taken into account for comparison with the value of the 
LINES parameter. 


Rules 
At least one of PRIORITY, MEDIA, or LINES must be specified. 


Examples 

MDC (A,B) 3 {default priority for classes A and B is 3} 
MDC Z MD=112B45 {default media for class Z is 112B45} 
MDC Z 3 1I12B45 {set both the default priority and media} 


MDC OC=B LINES=100000 
{outputs for class B have a maximum size of 100,000 


lines} 


MDC OC=Z LINES=* {there is no limit on the number of lines for outputs of 
class Z} 
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8.3.5 
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MODIFY_CONFIGURATION (MDC) - MAIN OPERATOR 


Purpose 


Modifies elements of the configuration: output classes, pre-initialized load 
modules, resident system functions, dispatching priorities, memory dimensions. 


Syntax 


{ MODIFY CONFIGURATION } 
{ MDC } 


OUTCLASS 
OC 


PRIORITY 


Coal 
aan 
Il 


PRTY 


MEDIA } 


coal 
aan 
Il 
— 
is) 


] 
[a] ...) ] 
] 


] 
{ 0]1]2|3/4|5/6|7 } J 
] 


} = nameé ] 


coal 
aan 
| 


MD } 


STATION } 


— 
aan 


ST } 


[PLM [lib-name. .] 
[CLM = [lib-name..] 


] 


} = names ] 


] 


lm-name [:volume :dvc]] 
lm-name [:volume :dvc]] 


[ LINES = { * | char7 } ] 


Parameters 

OUTCLASS a list of up to 10 output classes whose characteristics 
are to be modified. Each class is expressed as a letter 
(A to Z). 

PRIORITY (with OUTCLASS) the new default output priority for 
the output class, expressed as a digit in the range 0 
to 7. 

MEDIA (with OUTCLASS) the new default output media for 


the output class. 
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STATION (with OUTCLASS) the name of the (unattended) 
station for which output class characteristics are to be 
changed. When omitted, this applies to the MAIN 
station. 


PLM/CLM the identification of a load module that is to be pre- 
initialized (PLM) or whose pre-initialization is to be 
cancelled (CLM). When the library-name is omitted, 
SYS.HLMLIB is assumed. 

LINES Specifies the maximum number of lines for an output 
in the given class. If * or 9999999 is specified, there 
is no limit. If this parameter is omitted, the current 
value is kept. 


The value of LINES must be greater than 0. Any job 
that creates outputs for the class concerned with more 
than the number of lines permitted by the LINES 
parameter is aborted with return code ERLMOV. 


The limit set by LINES does not concern dumps. 


Any buffering done by the OUTPUT-WRITER is not 
taken into account for comparison with the value of the 
LINES parameter. 


Rules 


e If STATION, PRIORITY, MEDIA, or LINES is used, then OUTCLASS must be 
used. 


e If OUTCLASS is used, at least one of PRIORITY, MEDIA, or LINES must be 
used. 


Examples 
MDC OC=Z 3 12B45 {modify characteristics of output class Z} 


MDC OC=(A,B) 3 ST=STN 
{modify output classes A and B default priority for 
station STN} 


MDC OC=B LINES=100000 
{outputs for class B have a maximum size of 100,000 
lines} 


MDC OC=Z LINES=* {there is no limit on the number of lines for outputs of 
class Z} 
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8.3.6 MODIFY_DEVICE_TRACE (MDDVTR) 
Purpose 
Modifies the number of events on a device (or devices) after which a warning 
message (AV 16) is issued. This threshold can be defined for a device, a range of 
devices or devices of a certain class. 
Syntax 
{ MODIFY DEVICE TRACE } 
{ MDDVTR } 
[ { DEVICE } { * ] 
[ { } = { dvtyp [dvnm] } ] 
[ { Dv } { dave ] 
[ { THRESHOLD } { 0 }] 
C { d= { iis 
[ { EVENTS } { dec3 } ] 
Parameters 
DEVICE the device(s) for which the threshold is defined, 
expressed as: 
* all devices, 
dvnm a specified device, 
dvtyp all devices of a type, 
dve all devices of a class. 
When omitted, all devices (*) are assumed. 
THRESHOLD the value of the threshold. When 0 or omitted, the 
warning message is never issued. When not zero, the 
warning message is issued each time the number of 
logged events becomes a multiple of the threshold. 
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Rules 

None. 

Examples 

MDDVTR {threshold becomes 0 for all devices} 
MDDVTR MS 100 {threshold is 100 for all disk units} 
MDDVTR MS/B10 {threshold is 0 for all MSU0555 disk units} 
MDDVTR MSO3 20 {threshold is 20 for disk unit MS03} 
NOTE: 


System initialization does not change the threshold value or the number of 
logged events. To reset the number of logged events to zero, use the PRLOG 
utility and the MODIFY_ERROR_LOG (MDERLOG) command. 
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8.3.7 MODIFY_DIMENSION (MDDIM) - BASIC ARM 


Purpose 


Change the MPL of the dimension (BASIC Level only). See the ARM User's Guide 
for full details. 


Syntax 


{ MODIFY DIMENSION } 
{ MDDIM } 


DIM = names 


MPL = dec3 
[ { SYSTEM } ] 
[ { } = name4 ] 
[ { sys } ] 
Parameters 
DIM The name of the dimension. 
MPL The new multiprogramming level. 
SYSTEM This parameter indicates the system where the 


command is executed. 


Rules 


User must be in a MAIN operator project. 


Example 


MDDIM IOF7 MPL=(10) 


{the multiprogramming level of IOF7 dimension is set 
to 10} 
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8.3.8 MODIFY_DIMENSION (MDDIM) - FULL ARM 

Purpose 

Changes the attributes and/or updates the XL (Execution Level) range of the 

dimension. See the ARM User's Guide for full details. 

Syntax 

{ MODIFY DIMENSION } 

{ MDDIM } 

DIM = name8 

[ MPL = (dec3[,dec3] ) ] 

[ XL = (dec3[,dec3] ) ] 

[ RELWGHT = dec3 ] 

[ BWGHT = dec3 ] 

[ { INDIVIDUAL } ] 

[ { } = bool ] 

[ { ICA } ] 

[ HOLD = bool ] 

[ { PRIORITY ATTRIBUTE } ] 
[ { PRTYATTR } = bool ] 
[ { PA } ] 
[ { SYSTEM } ] 

[ { } = name4 ] 

[ { sys } ] 

Parameters 

DIM The name of the dimension, for example: POOL3, 
TDSS, etc. 

MPL Multiprogramming level: a set of two decimal values, 
the first one being the minimum and the second being 
the maximum. If minimum = maximum, only one 
value is specified. MPL may range from 0 to 999. 
ARM periodically computes an optimized MPL value 
between those two limits. 
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XL 


RELWGHT 


BWGHT 


ICA 


HOLD 


PA 


SYSTEM 


Rules 


Definition of an XL range through a list of two values 
(XL=(n1,n2)). If minimum = maximum, only one 
value is specified. XL may range from 0 to 100. For 
the SYS dimension, XL max is equal to 100 and 
cannot be changed. 


Relative weight. Range from 1 to 100. Indicates the 
Relative Weight of the Dimension. The higher the 
weight, the more important the dimension. It is used 
when balancing resources between different 
dimensions. 


Balancing weight. This indicates the percentage of 
system balance rules applied to this dimension during 
calculation of XL as opposed to the specific 
requirements of the dimension. Range from 0 to 100. 


Individual Control Attribute. This is a protection level. 
If 1, specific isolation and protection methods must be 
used for every application of this dimension. If 0, there 
is no ICA. 


If 1, a step in the dimension may be held by ARM if 
necessary. If 0, a step cannot be held. 


Execution Priority attribute. This indicates if steps are 
discriminated against inside the dimension, according 
to their job priority (XPRTY). 


The system on which the command is to execute. 


e The dimension name and at least one of the other parameters must be present. 


e The ARM level must be FULL for all parameters, except DIM and MPL which 
can be used in BASIC level. 


e Ifthe dimension is SYS only the MPL parameter can be specified. 


Examples 


MDDIM POOL4 MPL= (2,20) 


{the multiprogramming level range of dimension 
POOL4 is modified} 


MDDIM IOF7 XL=(55,70) 
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8.3.9 MODIFY_DJP (MDDJP) 


Purpose 


Specifies the amount of transfer activity allowed between the local site and a 
remote site, or modifies the maximum number of job readers on the current site. 


Syntax 


{ MODIFY DJP } 
{ MDDJP } 


SITE = sitenm 


TFRNB = tfnb 


al 


STRONG = bool ] 


coal 


WAITIME = dec2 ] 


[ NWKD = { NO|MON|TUE|WED|THU|FRI|SAT|SUN } ] 


ll 


[ YEAR = dec4 ] 


cal 


HOLIDAYS = dec3 ] 


cal 


HOLIDAYS MODE = {RPL|ADD|DL} ] 


[ UFTWAIT = HH.MM ] 


Parameters 

SITE Name of the site with which transfer activity is to be 
modified. 

TFRNB The number of transfers that can take place 


simultaneously between the local site and the one 
specified by SITE. When 0, no transfer is possible. 
If SITE=current site, then TFRNB specifies the 
maximum number of job readers that can be started 
simultaneously on the site. 
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STRONG 


WAITIME 


NWKD 


YEAR 
HOLIDAYS 


HOLIDAYS MODE 


RPL 
ADD 
DL 
UFTWAIT 
Rules 


This parameter is meaningful only when TFRNB is 
less than the current number of transfers in progress. 
If 0 or not specified, the system waits for the normal 
completion of transfers in excess of TFRNB. 

If 1, excess transfers are immediately aborted. 


Time, in minutes, between two connections to the site 
given in the SITE = parameter. When a first connection 
fails, the default value is 5 minutes. 


Non Working Weekdays is used to designate 1 to 3 non 
working days of the week. NO means that all are 
working days. 


Designates the year. 


The Julian number (1 to 366) for each of the 1 to 60 
days in the year that are public holidays and no work is 
to be done. 


Specifies how public holidays given in HOLIDAYS 
are used: 

replace public holidays in the current list of specified 
year, 

add public holidays to the current list of specified year, 
delete public holidays from the current list of specified 
year. 


Waiting time in hours and/or minutes, between two 
data transfers (minimum = one minute, maximum = 72 
hours). 


e If WAITIME is used, then SITE (and SITE only) must be used. 
e If TFRNB is used, SITE must be used. 
e If HOLIDAYS is used, YEAR must be used. 
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Examples 
MDDJP SIT3 10 {10 transfer activities with site SIT3.} 


MDDJP SIT3 5 STRONG 
{Reduce transfer activity and abort excess transfers. } 


MDDJP WAITIME = 1 SITE = SIT3 
{A connection to SIT3 is attempted every one minute.} 


MDDJP NWKD 


(FRI, SAT) 
{The two non working weekdays are Friday and 
Saturday. The default id Saturday and Sunday. } 


MDDJP NWKD = NO {All the days of the week are working days. } 


MDDJP YEAR = 1991 HOLIDAYS = 

(1, 91, 127, 128, 129, 130, 227, 228, 305, 359) 
{For the year 1991, the public holidays are: January 
Ist, April Ist (Easter), May Ist (Labor Day), May 8th 
(1945 Victory), May 9th, May 10th, August 15th, 
August 16th, November 11th, and December 25th.} 


MDDJP YEAR = 2000 HOLIDAYS = (1,366) HOLIDAYS MODE = 
ADD 
{For the year 2000, add the public holidays: January 
1st and December 3 1st.} 


MDDJP YEAR = 2000 HOLIDAYS = (1,365) HOLIDAYS MODE = DL 
{For the year 2000, delete the public holidays: January 
1st and December 30th. } 


MDDJP YEAR = 2000 HOLIDAYS MODE = RPL 
{For the year 2000, there are no public holidays. } 


MDDJP UFTWAIT = 00:20 
{The connection to a remote site will be aborted if 
during 20 minutes no data transfer occurs. } 
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8.3.10 MODIFY_ERROR_LOG (MDERLOG) 


Purpose 


Modifies some entries in the SYS.ERLOG file. This command is to be used only 
under Service Center supervision. 


Syntax 
{ MODIFY _ERROR_LOG } 
{ MDERLOG } 
[{ DEVICE } { * }] 
{ } = { dvtyp [dvnm] }] 
[{ Dv } { dave }] 
Parameters 
DEVICE the device or devices for which error counters are to be 


reset, expressed as: 


* all devices, 

dvnm a specified device, 
dvtyp all devices of a type, 
dvc all devices of a class. 


When omitted, all devices (*) are assumed. 


Rules 

None. 

Examples 

MDERLOG {reset all counters} 

MDERLOG MS {reset counters for all disk units} 
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8.3.11 MODIFY_FILTER (MDFLT) 


Purpose 


Modifies (that is, activates or deactivates) a filter or a set of filters. 


Syntax 
{ MODIFY FILTER } 
{ MDFLT } 
{ SUSP } 
OPTION=  { } 
{ RESTART } 
{ FILTERSET } 
{ } = fltst 
{ FLTST } 
[{ FILTER } 
[{ S81 
[{ FLT } 
[ { SYSTEM } 
[ { } = name4 
[ { sys } 
Parameters 
OPTION the action to be performed: 


— SUSP suspend the action of a filter or filter set, 
— RESTART activate a previously suspended filter or 
filter set. 


FILTERSET when used alone (without FILTER), specifies the set of 
filters to be modified. When used in conjunction with 
FILTER, specifies the filter set to which the filter to be 


modified belongs. 
FILTER the filter to be modified. 
SYSTEM The system where the command is executed. 
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Rules 


None. 


Examples 
MDFLT SUSP Al A101 {suspend filter A101 within filter set Al} 


MDFLT RESTART Al {reactivate all filters of set Al} 


MDFLT SUSP Al {suspend all filters of set Al} 
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8.3.12 MODIFY_HARDWARE_CONFIGURATION (MDHW) 


Purpose 


This command inserts hardware resources into the GCOS 7 configuration (IN) or 
removes them (OUT). It is used by the operator for dynamic reconfiguration, that 
is, while the system is running. This command is not used for dynamic 
reconfiguration of the DPS 7000/A, DPS 7000/200/300 machines. See the 
appropriate Operator's Guide (hardware) and Chapter 10 Reconfiguration for more 


information. 
Syntax 
{ MODIFY HARDWARE CONFIGURATION } 
{ MDHW } 
{ hardware-unit } ] 
UNIT = { }] 
{ device-path } ] 
{ IN } ] 
ACTION = { }] 
{ ouT } ] 
SHARE { ] 
= { bool } ] 
SHR { }] 
TWINNING { }] 
= { bool } ] 
TWIN { }] 
NTWIN ] 


col 


FORCE = { bool } ] 
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Parameters 


UNIT Specifies the resources to be inserted into or removed 
from the configuration. There are two possibilities: 


— A hardware unit (4 characters) which can be: 


a CSS resource (IPnm, EPnn, FPnn, GPnn, JOnm, 
MuUhh, PXnm), 

a controller (xCnm), 

a peripheral device (dvnm). 


— A device-path (9 characters) representing the path to 
a peripheral device (xCnm.dvnm). 


ACTION if IN, the unit specified in the UNIT parameter is 
inserted into the GCOS 7 configuration. 


if OUT, the unit specified in the UNIT parameter is 
removed from the GCOS 7 configuration. 


NOTE: The last IPU, CPU board or IOP ofa 
configuration cannot be removed. 


SHARE This parameter must appear when ACTION=IN is 
specified if the unit is a shareable disk. There are two 
possible values: 


1 When this parameter is used, the shareable disk 
specified in the UNIT parameter is inserted into 
the GCOS 7 configuration and added to the list 
of SHARED devices. 


The disk must be OUT or SHARED on the 
other system. 


0 When this parameter is used, the shareable disk 
specified in the UNIT parameter is inserted into 
the GCOS 7 configuration and is private to the 
system. 


The disk must be OUT on the other system. 


If this parameter is omitted for a shareable device, 
SHARE=0 is assumed and warning message AW60 
(03) explained in the Console Messages Directory is 
sent to the operator. See also the Coupled Systems 
User's Guide. 
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This parameter concerns bisystem sessions on a 
redundant multiprocessor installation. 


1 CSS resources necessary to initiate another 
system on the installation are removed from the 
running GCOS 7 configuration. 


0 CSS resources available after termination of the 
second system in a bisystem session are 
inserted into the current GCOS 7 configuration. 


This parameter means no twin and it is the same as 
TWINNING=0. 


This parameter can only be used when ACTION=IN is 
specified for CPU and disk resources; the only 
possible value is 1. 


A disk device is unconditionally reinserted into the 
GCOS 7 configuration. 


When FORCE is specified for a shareable disk, 
exclusive access to the disk by another system is 
cancelled before its insertion into the current GCOS 7 
configuration. This option should be used with care as 
it may interrupt use of the disk by another system. 


Let a shareable MSO01 disk be accessible by an: 
— SO system through the MC01 controller 
— SI system through the MC02 controller 


In case of permanent and "accidental" seizure of MSO1 
by S1 caused by: 


1. amisuse of MDHW MSO1 IN SHR=0/1 
commands as for example: 


- for SO MDHW MSO1 IN SHR=1 
-then forSl MDHW MSO1 IN SHR=0 


2. ahardware problem on MC02 controller 


the only way for SO to regain access to MSO01 is to key 
in the MDHW MSO1 OUT and then 

MDHW MSO1 IN FORCE commands on behalf of the 
SO system. 
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The FORCE option forces the MSO1 reintroduction by 
unlocking the "parasitic" seizure. 


NOTE: this FORCE option must be used carefully 
because it may disturb the S1 operation. 


Rules 


e When an MU unit is specified, only the OPTION=IN parameter can be used. 
e TWINNING cannot be used with another parameter. 


e Either the TWINNING parameter must be used or the UNIT and ACTION 
parameters must be specified together in any MDHW command. 


e The SHARE and FORCE parameters are mutually exclusive. 


e An IOC can only be isolated if all channels linked to it are unused. When one 
allocated device with only one path through the IOC remains, the command is: 


— either rejected if the device is a system or resident disk or if it is a coupled 
volume, 
— or deferred in all other cases. 


The state of all channels remains unchanged. 


e Inthe current release, Boolean value parameter 0 is the only value which can be 
used in a TWINNING command because the only dynamic transition possible is 
from bisystem to monosystem. 


e With the TWINNING parameter, 0 value may only be used when the other 
system session has terminated and when the COUPLED switch on the SOP 
whose ENABLE lamp is lit is placed in the ON position. This command 
automatically reinserts CSS resources left available by the termination of the 
second system into the current GCOS 7 configuration. 


e When a memory unit has failed, all the MUs of the terminated system are kept 
out of the GCOS 7 configuration. The operator must set the valid MUs (except 
dedicated I/O cache memory units, see the rule below) in the configuration using 
as many MDHW MUxx IN commands as the number of valid MUs to be 
inserted. 


e A dedicated I/O cache memory unit (MU) cannot be dynamically reconfigured. 
This MU is not accessible to the system and remains in this state after the 
reconfiguration command. In other words, the MDHW MUxx IN command 
cannot be used for this MU. 


e When related to a MIRROR disk, the command MDHW IN/OUT SHARE=1/0 
must be used in manual operating mode (MDMIR MANUAL). 
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e Except when a specific action is required on one device, both disks of a pair of 
mirrored disks must be kept in the same state (both IN with the same shareability 
attribute, or both OUT). Refer to the Mirror Disks User's Guide. 


Examples 


MDHW 


MDHW 


MDHW 


MDHW 


MDHW 


MDHW 


MDHW 


MDHW 


IP51 IN 


EP04 OUT 


FPO5 IN 


TWIN=0 


MS15 IN SHR=0 


MCO5 OUT 


TCO5.MT23 IN 


MU1* IN 


{inserts IPU 51 into the configuration. } 
{removes EPU 04 from the configuration} 
{inserts FPU 05 into the configuration} 


{after the termination of one system in a bisystem 
session, inserts all CSS resources left free by this 
termination into the current configuration. } 


{shareable disk MS15 is inserted into the configuration 
as a private disk. } 


{the disk controller MCO5 is removed from the 
configuration. } 


{gives access to tape unit MT23 via tape controller 
TCO05 (path name=TC05.MT23).} 


{inserts all MU modules in the second Main Memory 
Unit into the configuration. } 
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8.3.13 MODIFY_INPUT_READER (MDIR) 


Purpose 


Starts or stops a permanent reader. 


Syntax 


{ MODIFY INPUT READER } 


{ MDIR 


Parameters 


STATE 


Rules 


None. 


Examples 
MDIR PERM 


MDIR NPERM 
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} 


} 
} 
} 


PERM starts a permanent reader, while NPERM 
stops it. 


{start a permanent reader} 


{stop a permanent reader} 
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8.3.14 MODIFY_IOF (MDIOF) 


Purpose 


Modifies the lapse of time during which reconnection of accidentally disconnected 
IOF users is possible and/or the lapse of time after which idle IOF users are 


disconnected. 
Syntax 
{ MODIFY IOF } 
{ MDIOF } 
[{ RECN TIME } { * ] 
{ }={ 0 ] 
[{ RT } { dec2 }] 
[{ IDLE TIME } { * ] 
[{ }=f{ ] 
[{ IDT } { dec2 }] 
Parameters 
RECN_TIME the lapse of time during which reconnection is allowed 
as follows: 
* no time limit for reconnection 
0 reconnection is not allowed 
nn reconnection must occur within nn minutes of the 
accidental disconnection. 
IDLE_TIME the lapse of time after which idle IOF users are 


disconnected. 
* No idle time limit is defined. 
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Rules 
At least one of RECN TIME or IDLE_TIME must be specified. 


Examples 

MDIOF * {set no limit to reconnection time} 

MDIOF 0 {no reconnection is allowed} 

MDIOF 15 {reconnection must occur within 15 minutes of the 
accidental disconnection} 

MDIOF 15 6 {set reconnection time to 15 minutes and idle time to 6 
minutes} 

MDIOF IDT=6 {set idle time to 6 minutes} 
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8.3.15 MODIFY_JOB (MDJ) 


Purpose 


Modifies the characteristics of jobs. A job may only be modified by its submitter, 
by its USER and by main or station operators. 


Syntax 
{MODIFY_JOB} 
{MDI } 
[RONS = (ron [ron] ...)] 
[{SELECT} {jclass}[  {usernm}[  {projnm}]]] 
[{ pat }t/ { EL }11] 
TASER ‘oh’ Ae, SR ape: ERT Ap. ee al 
[CLASS = aa] 
[{PRIORITY} ({spr} [{xpr}])] 
C{ b= ( Le eae 
[{PRTY } ({ * JIL * }))] 
[ON = (dec2 [dec2] ...)] 
[OFF = (dec2 [dec2] ...)] 
[{SYSTEM} ] 
[{ } = name4] 
[{sys } ] 
[{JOBSTATE} ] 
[{ } = ALL|SCH|EX|SUSP|IN|HOLD] 
[{JSTATE } ] 
[ {JOBNAME } ] 
[ } = names] 
[ {JNM } ] 
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Parameters 
RONS a list of up to 16 Run Occurrence Numbers of the jobs 
to be modified. When omitted, all jobs are assumed. 
SELECT restricts the scope of the command to the jobs that 
belong to the specified combination of jclass/user 
name/project. If SELECT=* all jobs are modified. 
CLASS the new class for the selected jobs. The class is one or 
two letters in the range A to P or AA to PZ. It cannot be 
changed once job execution has begun. 
PRIORITY the new priority for the selected jobs expressed as a 
pair of digits as follows: 
(scheduling-priority execution-priority), 
spr is an integer in the range 0-7 inclusive, 
xpr is an integer in the range 0-9 inclusive. 
(The lower the number, the higher the urgency). An 
asterisk leaves the corresponding value unchanged. 
ON/OFF a list of the switches to be set on or off. A switch is 
identified by a number in the inclusive range 0 to 31. 
SYSTEM indicates the system where the command is executed. 
JOBSTATE jobs to be modified by current state; jstate must be one 
of the following: ALL, SCH, EX, SUSP, IN, HOLD 
JOBNAME jobs to be modified by name (name-8) 
Rules 


When RONS is used, neither SELECT, JOBSTATE nor JOBNAME can be used. 


When neither RONS, SELECT, JOBSTATE, nor JOBNAME are specified, 
SELECT =* is assumed. 


ON and OFF may not be used simultaneously; they are mutually exclusive. 
RONS and SELECT are mutually exclusive. 


As with other parameters of the command, only an operator may modify jobs that 
he did not submit. 
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Examples 
MDJ CLASS=BZ {set all user-submitted jobs to class BZ} 
MDJ PRIORITY=(*,9) {set all user-submitted jobs' execution priorities to 9} 


X222 CC (5,3) {set job X222 to class CC with priorities 5 and 3} 


X222 ON=(7 17 21) 
{set switches 7, 17 and 21 of job X222 to ON} 


PRIORITY=(7,*) {set the scheduling priority of all user-submitted jobs 
to 7} 


SEL=*/*/MYPROJ CLASS=AA 
{set all jobs belonging to the MYPROJ project to class 
AA} 


MJ JOBNAME=TEST2 ON= (1) 


{set switch | to ON for all jobs named TEST2} 
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8.3.16 MODIFY_LOAD (MDLD) 


Purpose 


Modifies the characteristics (multiprogramming level, default scheduling, and 
execution priorities) for specified classes. 


Syntax 
{ MODIFY LOAD } 
{ MDLD } 
[ { CLASSLIST } { * } ] 
ben } = { aa }] 
[ { cLass }  { aa[-aa] } ] 
[ { MULTI_LEVEL } ] 
ee } = dec3 ] 
[ { MULTI } ] 
[ { PRIORITY } ( { spr} { xpr } ] 
[ { PRTY i ee a 
[ MDMULTI =bool ] 
[ { SYSTEM } ] 
[ { } = name4 ] 
[ { sys } ] 
Parameters 
CLASSLIST the classes or range of classes whose characteristics are 


to be modified, expressed as: 


* 


class 


class-class 
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MULTL LEVEL the multiprogramming level for each one of the 
selected classes. The range is from 0 to 255. 


Some classes dedicated to service jobs (e.g. "Y") have 
a lower limit for the multiprogramming level. If the 
value given to the MULTI LEVEL parameter is 
outside that limit, the multiprogramming level is set to 
that limit. 


PRIORITY the new priority for the selected jobs expressed as a 
pair of digits as follows: 


(scheduling-priority execution-priority), 
spr is an integer in the range 0-7 inclusive, 
xpr is an integer in the range 0-9 inclusive. 


(The lower the number, the higher the urgency). An 
asterisk (*) leaves the corresponding value unchanged. 


MDMULTI if 1 enables MULTI-LEVEL to be modified later. 
if 0 MULTI-LEVEL cannot be modified later. 


SYSTEM This parameter indicates the system where the 
command is executed. 


Rules 

At least one of CLASSLIST, MULTL LEVEL, PRIORITY, or MDMULTI must be 
specified. 

Examples 

MDLD * 2 {set the multiprogramming level of each class to 2} 
MDLD AA-PZ 2 {set the multiprogramming level of classes AA to PZ 


to 2} 


MDLD AA 2 PRTY=(3,3) 
{set the multiprogramming level of class AA to 2 and 
both the scheduling and execution priorities to 3} 


MDLD PRTY= (3,3) {set both the scheduling and execution priorities of all 
classes to 3} 
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MODIFY_MIRROR_MODE (MDMIR) 


Purpose 


This command changes the mirror operating mode from AUTOMATIC to 
MANUAL and vice versa. 


It is available only if the system has been configured with MIRROR = YES. 


Syntax 
{ MODIFY MIRROR MODE } 
{ MDMIR } 
{ AUTO } 
MODE = { 
{ MANUAL } 
Parameters 
MODE AUTO changes the operating mode from MANUAL to 
AUTOMATIC. It has no effect if the mode is already 
AUTOMATIC. 
MANUAL changes the operating mode from 
AUTOMATIC to MANUAL. It has no effect if the 
mode is already MANUAL. 
Rules 


e In MANUAL operating mode, the system waits for an operator action or reply to 
a MOUNT or a RECOVER request related to a MIRROR disk. 


e The AUTOMATIC operating mode allows the system not to wait for the 
operator action or reply for such events: copy invalidation is performed and the 
processing continues with the MIRROR ALONE disk. 


Refer to Mirror Disks User's Guide. 


Examples 


MDMIR MODE = AUTO {Changes operating mode from MANUAL to 
AUTOMATIC and displays the message: 


MR 16 AUTOMATIC MIRROR MODE } 
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MODIFY_MOT (MDMOT) 


Purpose 


Defines the Message Of Today (MOT) or erases it. The Message Of Today is 
printed in the Job Occurrence Report (JOR) or all jobs and displayed to each IOF 
user when he logs on. 


Syntax 
{ MODIFY MOT } 
{ MDMOT } 
[{ MESSAGE } ] 
[{ MSSG } = char200 ] 
[{ MSG } ] 
[ { SYSTEM } ] 
[ { } = name4 ] 
Papers } ] 
Parameters 
MESSAGE the text of the Message-Of-Today. When omitted the 
current text of the Message-Of-Today is erased. 
SYSTEM This parameter indicates the system where the 
command is executed. 
Rules 
None. 
Examples 


MDMOT 'Welcome to the XYZ Computer Center' 
{Defines the Message-Of-Today. } 


MDMOT {Erases the Message-Of-Today. } 
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MODIFY_OPERATING_MODE (MDOM) 


Purpose 


Modifies the protocol of interaction between the system and the operator. 


Syntax 
{ MODIFY OPERATING MODE } 
{ MDOM } 
[ { INT }] 
[ MODE = { }] 
[ { CONS }] 
Parameters 
MODE the new protocol of interaction, as follows: 


— INT In this mode, the S: prompt is displayed 
permanently, except when the system is executing a 
request keyed in by the operator. The advantage is 
that the dialog with the system is simplified. The 
disadvantage is that system messages must wait 
until a command is entered before they can be 
displayed on the console. 


— CONS The S: prompt is only displayed when you 
press the <Break> or <Insert> key. The advantage is 
that messages are visualized as they appear. 


On the system main console, the default mode is 


CONS. 

Rules 

None. 

Examples 

MDOM CONS {console protocol: a break must be issued before each 
input} 

MDOM INT {revert to interactive protocol} 
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8.3.20 MODIFY_OUTPUT (MDO, MO) 


Purpose 


Modifies the characteristics of outputs. 


12s IMPORTANT: 
: This command applies only to the outputs on which the submitter has access 
rights 
Syntax 


{ MODIFY OUTPUT } 
{ MDO 


} 
{ MO } 


[ { (output14 [ output14 ] ...) } ] 
[ OUTPUT = { output14-output14 }] 
[ { * | Aub yd 

SELCLASS = a [-a] ] 

CLASS = a ] 

[ PRIORITY = {0|1]2]3|4|5|6|7} ] 

DEST = [ name8.] names ] 

COPIES = nn ] 

{ STATION } { * }] 

{ b= { }] 

{ ST } ={ stnnm }] 

{ SELECT } { user/project } ] 

{ } = { */project }] 

{ ee ee yal 

oe) ae a Wd 

{ JOBNAME } ] 

{ } = names ] 

{ JNM } ] 

[ { SYSTEM } ] 
{ } = name4 ] 
{ sys } ] 
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Parameters 


OUTPUT 


SELCLASS 
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a list of the names of up to 16 outputs whose 
characteristics are to be modified. These may take the 
following forms: 


1. alist of the names of up to 16 outputs: 


- Xnnnn:nnnnn} to refer to a specific 
output 
} (Xnnnn:name means 
the first output 
- Xnnnn:name } so named) 


- Xnnnn to refer to all outputs 
of a job. 


2. arange of outputs delimited by a lower and an 
upper boundary. This may take the following 
form only: 


- Xnnnn-Xnnnn to refer to all outputs 
of a range of jobs. 
The first ron must be 
lower than the second 
one. 


3. to refer to all outputs of all jobs, specify: 
- * or ALL (default when 
JOBNAME is specified) 


(meaningful only for output names in the form Xnnnn) 
restricts the scope of the directive to those outputs that 
belong to the specified class or range of classes. This 
may be expressed as: 


class for a single class 
class-class for arange of classes 


where class is a letter in the range A to Z. 


When SELCLASS is omitted, all existing and future 
outputs of the job are selected. 


47 A2 53US 


47 A2 53US 


Description of the Operator Commands (Part 2) 


CLASS the new class for the selected outputs: a letter in the 
range A to Z. 

PRIORITY the new priority for the selected outputs: a digit in the 
range 0 to 7 (the lower the priority number, the higher 
the urgency). 

DEST the new destination of the output(s) in the form: 


[host-name.] station-name 


COPIES the new number of copies (see DPRINT command). 


STATION restricts the scope of the command to outputs attached 


to the station specified. When omitted or when * is 
specified, there is no station restriction. 


SELECT restricts the scope of the command to outputs 


belonging to a specified user and/or project. Not 
meaningful when OUTPUT specifies a list of outputs 
(format 1). By default, only the outputs belonging to 
the command submitter are selected. 


JOBNAME restricts the scope of the command to the outputs of 


jobs with the name specified. If JOBNAME is 
specified, the default value for OUTPUT is *. 


SYSTEM indicates the system on which the command is to be 


executed. 


Rules 


SELCLASS is ignored for names of specific outputs (Xnnnn:nnnnn or 
Xnnnn:name). 


At least one of CLASS, DEST, PRIORITY, or COPIES must be used. 
DEST parameter must begin with a letter. 


If several output of the same job are given the same name, MDO Xnnnn :name 
only affects the first output with that name encountered by the system. 


When SELCLASS is omitted, the modified CLASS, PRIORITY, and DEST (but 
not the COPIES) apply to all existing and future outputs of the job. When 
SELCLASS=A-Z, only currently known outputs are modified. 


While the output is being printed, no modification in the number of copies can 
be taken into account before the start of the next copy. For example, if MDO 
COPIES=3 is entered during the printing of the third copy, the printer prints a 
fourth copy before it stops. 


CLASS, DEST and PRIORITY are ignored if output is already being printed. 
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e MDO COPIES=nn takes into account the number of copies already printed. For 
example, if 6 copies were requested and 3 have been printed, MDO Xron 
COPIES=8 does not change the number of copies already printed. Five more are 
printed for a total of 8. However, MDO Xron COPIES=4 results in just one 
more copy for a total of 4. 


e The parameters specified in $JOB with the EJ command or an anticipated MO 
(MODIFY OUTPUT) command override those specified in a batch job (OVL 
SYSOUT or WRITER) or in a IOF directive (DPR). 


Examples 


MDO X123 DEST=MAIN {print all outputs of X123 on one of the main site 
printers} 


MDO X123 CD 5 {set outputs of X123 of class C to class D and 
priority 5} 


MDO (X123:2 X123:RES) CLASS=C 
{set two selected outputs of job X123 to class C} 


MDO X123:1 CLASS=C DEST=HST1.STN2 
{modify class of one output and print it on a remote 
site} 


MDO X123:RES COPIES=6 
{provide six copies of named output} 


MDO * DEST=MAIN {reroute all outputs belonging to the command 
submitter and attached to the current station, to the 
MAIN station} 


MDO * DEST=MAIN ST=STN 
{reroute all outputs belonging to the command 
submitter and attached to station STN, to station 
MAIN} 


MDO X123 PRIORITY=6 
{modify the priority of all current and future outputs of 
job X123} 


MDO X123 A-Z PRIORITY=1 
{modify only the priority of currently existing outputs} 
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X123-X2167 CLASS=G 


{modify the class of all outputs, belonging to the 
command submitter, of the jobs whose RON is in the 
range X123 to X2167} 


X34-X382 SELCLASS=A-E PRIORITY=2 


* PQ 


* SELECT=U1/P1 


* JOBNAME=JOB1 


{modify the priority of all outputs, belonging to the 
command submitter, of the jobs whose RON is in the 
range X34-X382 and whose output classes are in the 
range A to E} 


{modify all class P outputs belonging to the command 
submitter, to class Q} 


CLASS=A COPIES=2 
{modify the class and number of copies of all outputs 
belonging to user U1 of project P1} 


PRIORITY=1 
{modify the priority of all outputs, belonging to the 
command submitter, of all jobs named JOB1 } 
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MODIFY_POWER_TIMER (MDPWRTM) (MDPOWER) (TPW) (MDPWR) 


Purpose 
This command modifies the values of both GCOS 7 power timers: 


e The Power Off Timer, indicating at what time the system will shut down, then 
power-off. 


e The Power On Timer, indicating at what time the system will power-on. 


Syntax 
{ MODIFY _POWER_TIMER } 
{ MDPWRTH } 
{ MDPOWER } 
{ MDPWRTPW } 
[ OFF { +interval }] 
[ = { date/time }] 
[ OFFDTM { CANCEL ] 
[ ON { +interval }] 
[ = { date/time }] 
[ ONDTM { CANCEL ] 
Parameters 
OFF Modifies the value given to Power Off timer. Can be 
given either in absolute form <date/time> or in relative 
form +<interval>. See examples below. If CANCEL is 
specified, the contents of the power off timer are 
cancelled. 
ON Modifies the value given to Power On timer. 
Rules 


e The Power On Timer cannot be set before the Power Off Timer. 


e The length of each element in the OFF and ON expressions is limited to 4 
characters, and the total length of each expression is 14 characters. 


e This command is not available on DPS 7000/2X0. 
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e Avoid setting the Power On Timer too short a time after the Power Off Timer: if 
the system receives the power-on command while the shutdown is still in 
progress, that command is ignored, and the system remains powered off. 


e This command is only available if H_TPC is started (The most convenient way 
to do this is to add the command to do so in the STARTUP file). 


Examples 


MDPWR {Displays the available ranges for the Power On and 
Power Off Timers (ranges depend on hardware)} 


MDPWR OFF=+02/03/00 
{Shut down the system and power-off in two days and 
three hours. 
Note: in the increment format only the dd/hh/mm 
components are accepted. } 


MDPWR OFF=+2/00/ ON=+2/00/00 
{Shut down the system and power-off in two hours, 
then power-on in two days} 


MDPWR OFF=90/03/21/09/30 ON=CANCEL 
{Shut down the system and power-off on March 
21st, 1990, at 9:30 AM; the Power On Timer is 
cancelled} 
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8.3.22 


Purpose 


MODIFY_RESTART_OPTIONS (MDRSO) 


Modifies some of the system initialization options, namely those related to remote 


operations. 


Syntax 


{ MODIFY RESTART OPTIONS } 


{ MDRSO 


} 


[REPEAT = bool] 


[AUTO = bool] 


[SILENT = bool] 


[{ DEVICE } 


} 


DV } 


= 
aoa 


Parameters 


REPEAT 
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When 1, the next system shutdown or crash is 
immediately followed by a restart, reload or re- 
initialization (depending on the system and the cause 
of the shutdown) without any operator intervention. 
This operation takes into account the disk unit 
identification stored in the service processor through 
the DEVICE parameter (refer to Section 3.3 Operating 
Modes). Consequently, when REPEAT is set to 1 the 
operator must check the device identification stored in 
the service processor. 


When 0, the next system shutdown will require a 
manual intervention from an operator to restart the 
system. In the case of CRASH the system is restarted 
and reloaded automatically, taking into account the 
unit that was the system disk in the current session. 
This operation is necessary to process consistently the 
DUMP related to the CRASH. 
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When 1, the next system restart (whether with or 
without operator intervention) is automatic, i.e. does 
not ask the operator any questions, provided that 
default replies have been stored in the 

RELOAD OPTIONS library member, as appropriate. 


When 0, the next system restart is run by the operator 
who is asked questions. 


When 1, the next system restart (with or without 
operator intervention) will result in no message being 
issued on the operator console; when 0, messages are 
issued. 


The identification of the system disk from which the 
system is to be initialized. Unlike the other three 
parameters, this option is retained for all subsequent 
system initializations until modified by a new 
MODIFY RESTART OPTIONS command. 


If AUTO = 0 then SILENT is ignored. 


Examples 
MDRSO DV=MS03 


MDRSO AUTO SILENT 


MDRSO REPEAT = 0 
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{redefine the initialization device} 


{next restart will ask no questions and issue no 
messages } 


{manual intervention is required for next restart} 
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MODIFY_STATION (MDST) 


Purpose 


Modifies the characteristics of a local (station operator) or remote (main operator) 


station. 


Syntax 


{ MODIFY STATION } 


{ MDST 


coal 


Coal 


coal 


{ 
{ 
{ 
{ 


“ae 


} 


ADDLDV = name4 ] 
DEVCLASS } { PR [/attr] } ] 
p= { ee 
pvc } { CD [/attr] } ] 
DEVICE } ] 
} = rfile78 ] 
DV } ] 
SELCLASS = a [-al] ] 


LCASE = bool ] 


CLDRV = { 


name4 } 


] 
i ed 


PRTDEST = names ] 


PHCDEST = names ] 


EBANNER = bool ] 
FBANNER = {0|1|2} ] 
BANCHAR = char2 ] 

{ RESCUE_ON } ] 
{ } = names ] 
{ RCON } ] 
{ RESCUE_OFF } ] 
{ } = names ] 
{ RCOFF } ] 


47 A2 53US 


[ { RESCUE CLASS } 


EA 


[ { RCCLASS 


[ { STATION } 


C { 
{ 


ST 


Parameters 


ADDLDV 
DEVCLASS 


DEVICE 


SELCLASS 


LCASE 


CLRLDV 


PRTDEST/PCHDEST 
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the four-character name of a logical device to be 
defined and made known to GCOS 7. 


(with ADDLDV) the device class of the logical device: 
printer, card reader or card punch. 


(with ADDLDV) the DPS 6 path name (possibly 
including the site name) identifying the file or device 
to act as the named logical device. See the rfile78 
parameter of the START _OUTPUT_WRITER 
command. 


Use of MDST DEVICE = rfile78, allows you to give a 
"DPS 7000 device-like" name to a remote device or 
file, for further use by a SOW or TOW command. 
(Such a name cannot be used to re-identify a 

DPS 7000 device.) 


(with ADDLDV) the default output class(es) attached 
to the logical device. This may be expressed as: 


class for a single class 
class-class for a range of classes 


where class is a letter (A to Z). When omitted, all 
classes are assumed. 


(with ADDLDV) when 1, the logical device is 
requested to keep lowercase when printing. 


the name of a logical device whose definition is to be 
erased. When * is used, all device definitions and 
options attached to the station are erased. 


the name of a station to which printouts (PRTDEST) or 
punchouts (PCHDEST) are directed. This can prove 
useful if a station has no printer (punch) or if it is 
expected to be down for a long time. 
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EBANNER whether an end banner is required (1) or not (0) for 
outputs. 

FBANNER The number of front banners (0, 1, 2) for outputs. 

BANCHAR a 2-character string. The first character to be used as a 


banner separator, and the second one to print the large 
characters on the banner. 


RESCUE_ON/RESCUE_OFF 
the name of another station to be used for rescuing 
(RESCUE _ON) or to stop rescuing (RESCUE_OFF) 
the station. When a station is rescued, output delivered 
and intended for that station is directed to the rescuing 
station, upon a special START OUTPUT_WRITER 
command. 


Rules 


e If ADDLDV is used, then both DEVCLASS and DEVICE must be used. 


e If DEVCLASS, DEVICE, SELCLASS or LCASE is used, then ADDLDV must 
be used. 


e If RESCUED CLASS is used, then either RESCUE _ON or RESCUE _OFF 
must be used. 


Examples 


MDST PR99 PR/H160 SYORK:>SPD>LPT00 A-I 
{define PR99 as the name of a printer at DPS 6 site 
YORK where it is known as >SPD>LPT00. 
When command SOW PR99 is issued, the writer 
processes classes A to I} 


MDST CLRLDV=PR99 {erase the previous definition} 


MDST RCON=ST3 ST=ST2 
{ask station ST2 to be rescued by station ST3 (this can 
only be issued by a main operator)} 


MDST RCOFF=ST3 ST=ST2 
{cancel the effect of the preceding command} 


MDST RCON=ST3 RCCLASS=A-Q 
{ask for station ST3 to rescue for output classes A to Q 
(used by a station operator) } 
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MODIFY_SYSTEM_TRACE (MDSYSTR) (MSYSTR) 


Purpose 

It activates or resets the following trace system selection filters for domains: 
e the active trace event EVID range, 

e the equality of a STRING to a trace event substring, 


e the submitter XRON. 
The MSYSTR command updates only the filters specified. 


NoTE: 
This command should be used under supervision of a Bull support engineer. 


Syntax 

{ MODIFY SYSTEM TRACE } 

{ MDSYSTR } 

{ MSYSTR } 
{ DOMAIN} {ALL }] 
{ DM } = { Jel 
{ TDOM } { name63 } ] 

[ EVID = ( dec4,dec4 ) ] 


[ STRING = hex8,OFFSET = hex2  ] 


XRON = { ron | Xnnnn }] 


[ RESET = bool ] 


Parameters 

DOMAIN It is the name of a system trace domain, or if ALL (the 
default) is specified, all domains. Maximum length is 
63 characters. 

EVID It is the active trace range, represented by a minimum 


value followed by a maximum value. The effective 
range is | - 4095. The maximum value must be greater 
than or equal to the minimum value. 
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STRING It is the string value (max length = 8 char hex) to be 


compared to an event substring. 


OFFSET This is the substring displacement (max 2 char hex) in 


the trace event: DA<OFFSET<19 


XRON This is the external RON number. Maximum length is 


5 characters. 


RESET If 1, all trace domain filters are cleared; if 0, the filters 


are not cleared. 


Rules 


The EVID filter applies to distributed requests that trace events with HDR=0 or 
HDR=1, and to variable length data trace events. 


The STRING filter is defined for fixed length distributed trace event requests. 


The XRON filter applies to all distributed trace requests. This filter must be 
cleared by operator command when the defined job terminates. 


RESET clears all trace domain filters. 
RESET and EVID are mutually exclusive. 
RESET and STRING are mutually exclusive. 
RESET and XRON are mutually exclusive. 


Examples 


MSYSTR XRON=X25 {Accept only trace requests issued from job X25 for 


all trace domains. } 


MSYSTR DOMAIN=MYTDOM EVID=(128,256) XRON=X25 


{For domain MYTDOM, accept only trace requests 
issued by job X25, and filter trace event requests with 
the specified EVID range.} 


MSYSTR DOMAIN=MYTDOM RESET 
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{Reset all MYTDOM trace domain filters. } 
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8.3.25 MODIFY_TERMINAL_OUTPUT (MDTO) 


Purpose 


Modifies the characteristics of an output to be printed by the Generalized Terminal 
Writer, or makes a Generalized Terminal Writer output eligible to be printed by the 
system output writer. Refer to the GT Writer User Guide for a complete description. 


Syntax 


{ MODIFY TERMINAL OUTPUT } 
{ MDTO } 


OUTPUT = Rnnnn 
[CLASS = a] 

[PRIORITY = deci] 

[TWDEST = namel2 ] 

[OWDEST = { names | MAIN } } ] 
[COPIES = dec2 ] 

[NUMBER = bool ] 


[MEDIA = name6é ] 


Parameters 

OUTPUT the name of the output to be modified. A Generalized 
Terminal Writer output name has the form Rnnnn and 
is provided as the result of the DPRINT command 
(with parameter TWDEST). 

CLASS the new class for the output: a letter in the range A 
to Z. 

PRIORITY the new priority for the output: a digit in the range 0 
to 9. 

TWDEST the name of the terminal or pool of terminals where the 


output is to be redirected. 
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OWDEST 


COPIES 
MEDIA 


NUMBER 


Rules 


the name of the station where the output is to be 
printed by the system output writer. When MAIN is 
specified, the system main pool of printers is assumed. 


number of copies. 


This parameter defines both the printing form and the 
paper or belt to be mounted. When TWDEST is not 
specified, the first two characters refer to a paper belt 
and the last four to a paper format. When TWDEST is 
specified, it defines the paper to be used on the 
terminal; if omitted, the default is the form currently 
mounted on the terminal specified by TWDEST. 


If 1, the line numbers are printed. 


OWDEST and TWDEST are mutually exclusive. 


Examples 


MDTO R1234 TWDEST=POOL12 


{Redirect the output to another pool of terminals. } 


MDTO R1234 OWDEST=MAIN 


{Redirect the output to the system main pool of 
printers. } 


MDTO R1234 CLASS=T PRIORITY=2 
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{Change the output class and priority. } 
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8.3.26 MODIFY_TERMINAL_WRITER (MDTW) 


Purpose 


Modifies the characteristics of a terminal or pool of terminals used by the 
Generalized Terminal Writer. Only the owner of the object terminals or users 
declared as Master Operators for the Generalized Terminal Writer may use this 
command. Refer to the GTWriter User Guide for a complete description. 


Syntax 

{ MODIFY TERMINAL WRITER } 
{ MDTW } 
{ MTW } 


CURRENT_TWDEST = name12 
TWDEST = { namel2 | NO } ] 
OWDEST = { names | MAIN } ] 
OWNER = { namel2 | NO } ] 
MOUNT = bool ] 

KEEP = bool ] 

INVCHAR = { NONE | charl } ] 


{ PADDING } 
} = dec2 ] 


{ 

{ PAD 
{ BLOCKING } 

{ } = dec5 ] 
{ BLOCK } 

ID = name8 ] 


NODE = name4 ] 


RETRYCT = dec3 ] 


[ MEDIA = charé6é ] 
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Parameters 


CURRENT_TWDEST 


TWDEST 


OWDEST 


OWNER 


TEST = bool ] 


[ ACCOUNT = bool ] 


[ STREAM = bool ] 


[ DISCO = bool ] 


the name of the terminal or pool of terminals whose 
characteristics are to be changed. 


the name of a terminal or pool of terminals where all 
outputs addressed to CURRENT TWDEST are to be 
redirected. If NO is specified, redirection is 
discontinued and outputs are again handled by the 
original terminal or pool. 


the name of a station where all outputs addressed to 
CURRENT_TWDEST are to be redirected and 
processed by the system output writer. When MAIN is 
used, the pool of system printers is assumed. 


the name of the owner of the terminal (that is, the 
person who is in charge of mounting the paper and 
performing similar operations). When NO is specified, 
the terminal has no owner; mount and recovery 
requests are sent to the owner of the output being 
printed. 


MOUNT/KEEP/IN VCHAR/PADDING/BLOCKING/RETRYCT 


ID 
NODE 
MEDIA 


TEST 


ACCOUNT 


refer to the Generalized Terminal Writer User's Guide. 
the terminal mailbox name to be changed. 
the node name to be changed. 


the name of the paper (media) which is mounted on the 
terminal. This is used in response to a mount request or 
to specify that the named paper is premounted. 


(with MEDIA only) requests the printing of the print 
test defined for the paper (media) specified by 
parameter MEDIA. 


if 1, the system accounting must be activated for this 
terminal; if 0, the system accounting does not have to 
be activated for this terminal. 


47 A2 53US 


Description of the Operator Commands (Part 2) 


STREAM if 1, reports are printed at the terminal without any 
control or formatting; if 0, the GT Writer manages the 
control and formatting of reports. 


DISCO if 1, the terminal is logged off by the GTWriter at the 
end of each report; if 0, the terminal is logged off by 
GTWriter when there is no further report to be printed 
at this terminal (unless the terminal has the KEEP 
attribute). 


Rules 


e TWDEST and OWDEST are mutually exclusive. 
e TEST may be specified only when MEDIA is specified. 


Examples 


MDTW POOL2 TWDEST=POOL1 
{redirect all outputs intended for POOL2 to POOL 1} 


MDTW POOL2 TWDEST=NO 
{revert outputs for POOL? to original destinations} 


MDTW POOL2 OWDEST=MAIN 
{redirect outputs for POOL2 to a system printer} 
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8.3.27 MODIFY_TIME (MDTIME) (MDTM) 


Purpose 


Modifies the standard local time; useful to set winter and summer time. 


Syntax 

{ MODIFY TIME } 
{ MDTIME } 
{ MDT } 


[ { SYSTEM } ] 
} = name4 ] 
[ { sys } ] 


coal 


Parameters 


SHIFT Given in hours and minutes, this parameter specifies 
the shift between GMT (Greenwich Mean Time) and 
the standard local time. When used, HH (hours) must 
be 01 to 23, MM (minutes) 01 to 59. The default 
SHIFT is positive (+) making local time lead GMT. 
When negative, GMT leads local time. 


With the SYNC parameter, the command takes the 
new Time Deviation from the Time Deviation Register 
(TDR) of the Service Processor and enters it in 

GCOS 7 as the Time Deviation. Meaningless on 

DPS 7000/2X0/3X0 systems. 


SYSTEM This parameter indicates the system where the 


command is executed. 


NoTE: 
From GCOS 7-V7 TS7458, system time can be set backward, using the 
MODIFY_TIME command (even when journalization is active). 
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Examples 


MODIFY TIME SHIFT=+1 {local time leads GMT by 1 hour} 
MODIFY TIME SHIFT=1 


MODIFY TIME SHIFT=0 {local time is GMT} 


MODIFY TIME SHIFT= -2 {GMT leads local time by 2 hours} 
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MODIFY_USER_REQ (MDUR) 


Purpose 


Modifies file transfer or jobset requests. 


Syntax 


{MODIFY _USER_REQ} 


{MDUR 


REQUEST = 


[RCLASS = 


[RPRIORITY 


{names [name8] ...} 
a] 


= 0[1|2|3|4/5]6|7] 


[HOST = names] 


fe 
ea 
a 
| 
[ee outen Tantun Vanten tanto’ 


IMMED 
[mm.dd. [yy] yy] .hh.mm 


+dddd{w|D|H|M} 
when-clause 


} 
} 
} 
} 
} 


a ee ee 


[ {W|WEEK 

[ {D| DAY 

[ {H|HOUR 
[EVERY = ([dec5] {M|MIN } [dec5]) 
[ eee 

[ {WKD 

[ {NW 

[TIMEOFF = bool] 

(WAIT = (name8[name8] ...)] 
[NOWAIT = bool] 

[ {CANCEL |NO}] 

[ { IMMED }] 
[RRESTART = { }] 

[ {delay }] 

[ {delayE }] 
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Parameters 


REQUEST 


RCLASS 


RPRIORITY 


HOST 


WHEN/EVERY/WAIT 


TIMEOFF 
NOWAIT 
RRESTART 
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a list of up to 16 names of requests to be modified. 
Each name may take one of the following three forms: 


— Jnnnnnnn a Jobset Occurrence Number (JON) 


— Fnnnnnnn a File transfer Occurrence Number 
(FON) 


— name8 the symbolic name of a request, as specified 
by the NAME parameter of the ENTER JOB REQ 
or ENTER_FILETRANS REQ commands. 


JONs and FONs are provided as results of the 
ENTER JOB REQ or ENTER FILETRANS REQ 
commands. They are unique identifiers for the 
corresponding requests. 


the new class for the request, expressed as a letter in 
the range A to Z. 


the new priority for the request, expressed as a number 
in the inclusive range 0 to 7. The lower the number, the 
higher the urgency. 


(jobset requests only) the new host where the jobset is 
to be executed. 


new wait conditions for the request. See the parameters 
with the same names in ENTER _JOB_ REQ and 
ENTER_FILETRANS_ REQ commands. If EVERY = 
(0,0) is specified, the repeat condition is cancelled and 
other enqueuing parameters are left unchanged. 


If 1, cancel the WHEN and EVERY conditions. 
If 1, cancel the WAIT condition. 


Specifies various possibilities for handling requests 
that were received while the system was off. 


For further information, consult Appendix E. 
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Rules 


e WAIT and NOWAIT are mutually exclusive. 
e TIMEOFF is exclusive of WHEN and EVERY. 
e HOST is ignored for file transfer requests. 


e When the year is expressed with 4 digits in the WHEN expression, it must verify 
the interval: 1961 =< yyyy < 2060. 


Examples 
MDUR J18 Z {Change class of J18 to Z.} 


MDUR F36 RPRIORITY=0 
{Change priority of F36 to 0.} 


MDUR MYJS HOST=HST1 
{Change execution host of jobset MYJS.} 


MDUR J37 TIMEOFF {Ignore time condition for J37.} 


MDUR F5 WAIT=(F3 F4) 
{Make F5 begin only when both F3 and F4 have been 
completed. } 


MDUR J1234 WHEN=03.01.9200.00 EVERY=52W 
{Execute on March Ist 1992 and repeat every 52 
weeks. } 
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8.3.29 MODIFY_VOLUME (MDV) 


Purpose 


Makes allocation of temporary files (im)possible on a resident volume or clears the 
locks set by the other system (of a set of coupled systems) after a failure of this 
other system. 


Syntax 


{ MODIFY VOLUME } 
{ MDV } 


NAME = name6é 


{ CLEAR } 
ACTION = { TEMP } 
{ NTEMP } 
Parameters 
NAME the name of the volume (Volume Serial Name) which 
is the object of the action. 
ACTION the action to be performed on the volume expressed as: 


CLEAR - to clear the locks set by the other system ofa 
set of two coupled systems after a failure of that other 
system. Meaningful on a SHARED volume only 
(rejected otherwise). 


TEMP - to allocate temporary files on named volume. 
NTEMP - to make allocation of temporary files no 
longer possible on the named volume. 


47 A2 53US 8-75 


GCOS 7 System Operator's Guide 


Rules 


When related to a SHARED MIRROR volume, the MDV CLEAR command must 
be used after issuing the RSCMIR command. 


Refer to Mirror Disks User's Guide. 


Examples 


MDV XYZ123 CLEAR {clear locks on coupled volume XYZ123} 


MDV WK12 TEMP {to allocate temporary files on resident volume 
WK12} 
MDV WK12 NTEMP {make allocation of temporary files on resident 


volume WK12 no longer possible} 
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8.3.30 MODIFY_XL_CLASS (MDXLC) 
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Purpose 


Modifies one or more parameters of an XL Class (XLC, or eXecution Level Class). 
See the ARM User's Guide for full details. 


Syntax 


{ MODIFY XL CLASS } 
{ MDXLC } 


HARDWARE PRIORITY } 


{ ] 
[ { HWPRTY } = (dec2,dec2) ] 
[ { HPRTYRANGE } ] 
[ { ENTRY PRIORITY } ] 
[ { } = dec2 ] 
[ { EPRTY } ] 


[ MAXCPU = dec3 ] 


[ { SYSTEM } ] 
[ { } = name4 ] 
[ { sys } ] 
Parameters 
XLC current XLC named in the command. New XLCs 


cannot be created. 


ATTR type of CPU processing. There are three possible 
control modes: Fixed non sliced (F), Fixed sliced (FS) 
or optimized (O). The Fixed sliced control mode uses 
the slice mechanism. The Optimized control mode uses 
dynamic changes of hardware priority. 
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HWPRTY/HPRTYRANGE 
range (from 8 to 15) of hardware priorities that may 
have a process belonging to the CPU class. The two 
hardware priorities may be equal. The highest 
hardware priority of XL CLASS n must be inferior to 
the highest hardware priority of the XL CLASS (n-1). 
(see Rules below) 


EPRTY entry priority of a process. It is the priority a process is 
allocated when it is started. Must be within the priority 
range (see HPRTYRANGE above). 


MAXCPU maximum CPU consumption rate a process may use 
before it is penalized. Range is from 0 to 100. 


SYSTEM This parameter indicates the system where the 
command is executed. 


Rules 


e An XLC number and at least one of the other parameters must be specified. 


e The lowest priority value for a given XLC (on the left inside the parenthesis) 
must be less than or equal to the lowest priority value for the next XLC. 
Remember that hardware priorities increase as their corresponding values 
decrease; priority 8 is greater than priority 15! 


Example 


MDXLC 1 HWPRTY=(8,13) 
MDXLC 2 HWPRTY=(9,15) is accepted 
MDXLC 3 HWPRTY=(9,9) 


MDXLC 2 HWPRTY=(9,9) 
MDXLC 3 HWPRTY=(8,9) is refused 


(Keep your eyes on the left-hand column: 8-9-9 is OK, 9-8 is not.) 


Example 


MDXLC XLC=3 EPRTY=9 MAXCPU=70 HPRTYRANGE= (8,10) 
{Update some parameters of XLC 3} 
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MWENVT (Modify Working Environment) 


Purpose 


Modifies the current working environment or displays the names of the 
environments that may be accessed by the operator. Several different environments 
may be accessible to operators: system operator, network operator, device operator, 
etc. Their definition is dependent on the installation. 


Syntax 
MWENVT 
[ENVT = namel12] 

Parameters 

ENVT the name of the environment which is to become the 
new current working environment. When omitted, the 
command lists the names of the environments that are 
accessible to the operator. 

Rules 


The named environment must: 


1. be the name of an existing environment, 


2. be accessible to the project under which the operator is logged. 


Examples 
MWENVT {list the accessible environments } 
MWENVT PPREP {switch to environment PPREP} 
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8.4 "N" and "R" Commands 


8.4.1 NAME_VOLUME (NV) 


Purpose 


Names a non-standard disk, tape, or cartridge volume. This may be used to name 
the premounted non-standard volume or as a reply to a request to mount the 
volume, usually to perform a volume preparation. 


Syntax 

{ NAME VOLUME } 

{ NV } 
{ DEVICE } 
{ } = dvnm 
{ DV } 


VOLNAME = volnm 


Parameters 

DEVICE the identification of the device on which the named 
volume is mounted or premounted. 

VOLNAME the name of the premounted volume. 

Rules 

None. 

Examples 

NV MTO3 TAPE6 {Name volume TAPE6 on tape drive MT03.} 

NV MSO2 INPUT {Name volume INPUT on disk drive MS02. 
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8.4.2 RELEASE_GCL_CACHE (RGC) 


Purpose 


This command restarts the cache function after a HOLD_GCL_CACHE command 
has put the function on hold. The cache function is interrupted to allow the system 
to make swappable the segments used by the cache function. The segments in 
question are those which are RESIDENT when the cache function is operational. 


The RELEASE _GCL_CACHE command is used once the above-mentioned 
segments have been made swappable. 


{ RELEASE GCL CACHE } 
{ RGC } 


Parameters 


None. 


Rules 


None. 
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8.4.3 RELEASE_JOB (RJ) 


Purpose 


Cancels the effect of the HOLD_JOB command, putting HELD jobs in the IN 
SCHEDULING state, and SUSPENDED jobs in the EXECUTING state. A job 
may only be released by its submitter, by its USER and by main or station 


operators. 


Syntax 


{RELEASE JOB} 
{RI } 


[RONS = 


[{SELECT} 


{ 
[{SEL 


[STRONG 


[ {SYSTEM} 
; } 


sys } 


[ 


Parameters 


RONS 


SELECT 


STRONG 


SYSTEM 
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{jclass}[ {usernm} 


* 


(Xnnnn [Xnnnn] ...)] 


eae 
‘ss ace 


{bool |0}]] 


] 
name4] 


] 


a list of up to 16 Run Occurrence Numbers of the jobs 
to be released. 


restricts the scope of the command to the jobs that 
belong to the specified combination of jclass/user- 
name/project. SELECT=* releases all held or 
suspended jobs accessible by terminal user. 


if 1, jobs are released regardless of their hold count 
values (see ENTER_JOB_REQ command for this 
feature). 


This parameter indicates the system where the 
command is executed. 


47 A2 53US 


47 A2 53US 


Rules 


Description of the Operator Commands (Part 2) 


e RONS and SELECT are mutually exclusive. 


e When neither RON nor SELECT is specified, SELECT=* is assumed and all 
suspended jobs accessible by terminal user are released. 


Examples 


RJ 


RJ 


RJ 


RJ 


RJ 


(X123 X456) 
X123 STRONG 
SL=AA 


SL=*/JONES 


{release all held jobs submitted by the user} 
{release two jobs} 

{release job, regardless of hold count value} 
{release all AA class jobs} 


{release all jobs submitted under the user-name 
JONES} 
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8.4.4 RELEASE_OUTPUT (RO) 


Purpose 


Cancels the effect of a previous HOLD_OUTPUT command by restarting the 
printing of suspended outputs or making held outputs eligible for printing. This 
command is also used to cancel the effect of the WHEN clause of the DPRINT or 
MODIFY _OUTPUT_PARAMETERS (MDOP) commands or of the OUTi 


parameter group. 


1@s IMPORTANT: 
s This command applies only to the outputs on which the submitter has access 
rights 

Syntax 

{ RELEASE OUTPUT } 

{ RO } 
[ { (output14 [ outputl14 J )}] 
[ OUTPUT = { output14-outputl14 }] 
[ { * | ALL fd 
[ SELCLASS = a [-a] ] 


cal 


STRONG = { bool | 0 } J 


[ { STATION } { * }] 
C { }={ aLL } ] 
[ { st } { nameg } ] 
[ { SELECT } { user/project 
[ { } = { */project 
[ { ee ae be 

[ { SEL }  {* 

[ { JOBNAME } ] 

[4 } = name8 ] 

[ { JNM } ] 

[ { SYSTEM } ] 

[ { } = name4 ] 

[ { sys } ] 


8-84 


47 A2 53US 


47 A2 53US 


Parameters 


OUTPUT 


SELCLASS 


STRONG 
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Output(s) to be released. The following formats are 
allowed: 


1. alist of the names of up to 16 outputs: 


- Xnnnn:nnnn } to refer toa specific 
output 
} (Xnnnn:name means the 
first output 
- Xnnnn:name }_ sonamed) 


- Xnnnn to refer to all outputs of 
a job. 


2. arange of outputs delimited by a lower and an 
upper boundary. This may take the following 
form only: 


- Xnnnn-Xnnnn _ to refer to all outputs ofa 
range of jobs. The first RON must be lower 
than the second one. 


3. to refer to all outputs of all jobs, specify: 


- * or ALL (default when 
JOBNAME is specified) 


(meaningful only for output names in the form Xnnnn) 
restricts the scope of the command to those outputs 
that belong to a certain class or range of classes. This 
may be expressed as: 


class for a single class 
class-class forarange of classes 


where class is a letter in the range A to Z. 


When SELCLASS is omitted, all existing and future 
outputs of the job are selected. 


When SELCLASS=A-Z is specified, only existing 
outputs are selected. 


if 1, makes outputs eligible for printing, bypassing any 
WHEN clauses that have been specified on the 
DPRINT command. Default value is 0. 
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STATION 


SELECT 


JOBNAME 


SYSTEM 


Rules 


restricts the scope of the command to outputs attached 
to the station specified. When omitted or when * or 
ALL is specified, there is no station restriction. 


restricts the scope of the command to outputs 
belonging to a specified user and/or project. Not 
meaningful when OUTPUT specifies a list of outputs 
(format 1). By default, only the outputs belonging to 
the command submitter are selected. 


restricts the scope of the command to the outputs of 
jobs with the name specified. If JOBNAME is 
specified, the default value for OUTPUT is *. 


indicates the system on which the command is to be 
executed. 


e Ifseveral outputs of the same job are given the same name, RO Xnnnn :name 
only affects the first output with that name encountered by the system. 


e SELCLASS is ignored for names of specific outputs (i.e. Xnnnn:nnnnn or 
Xnnnn:name). 


Examples 

RO X23 

RO X23 Z 

RO X23 A-I 

RO X23 :2 

RO X23 :PUNCH 
RO (X23 :2 X23 
RO X23 STRONG 


RO 


RO 


X123-X2167 


{release all held outputs of job X23} 
{release all held outputs of job X23 that are of class Z} 


{release all held outputs of job X23 that are of classes 
Ato lI} 


{release specified outputs of job X23} 


{release all outputs of job X23, bypassing all WHEN 
clauses. Also enqueues the READY outputs} 


{release all outputs, belonging to the command 
submitter, of the jobs whose RON is in the range X123 
to X2167} 


{release all class Z outputs, belonging to the command 
submitter, of all jobs} 
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RO * SELECT=U1/P1_ {release all the outputs belonging to user U1 of project 
Pl} 


RO * STATION=BC10 _ {release all outputs, belonging to the command 
submitter, that are attached to the station BC10} 


RO X123-X2167 A ST=BC10 SEL=U1/P1 
{release all class A outputs of jobs in the range X123 
to X2167 that are attached to station BC10 and belong 
to user U1 of project P1} 


RO JOBNAME=JOB1 {release all outputs, belonging to the command 
submitter, of the jobs named JOB1} 
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8.4.5 RELEASE_TERMINAL_OUTPUT (RTO) 


Purpose 


Cancels the effect of the HOLD_TERMINAL OUTPUT command by making a 
held terminal output eligible for printing, or by restarting the printing of a 
suspended or frozen terminal output. Refer to the GTWriter User Guide for a 
complete description of the Generalized Terminal Writer. 


{ RELEASE TERMINAL OUTPUT } 


Syntax 
{ RTO 
OUTPUT 
[ FROM 
STRONG 
BANNER 
Parameters 
OUTPUT 
FROM 
STRONG 
BANNER 
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} 


5} ] 
c5} ] 
5} ] 
} 
} 
{ bool | 0 } J 
{ bool | 2} J 


a list of up to 16 names of outputs to be released. A 
Generalized Terminal Writer output name has the form 
Rnnnn and is provided as the result of the DPRINT 
command (with TWDEST parameter). 


(for a frozen output only) the page where printing is to 
restart expressed as a number of pages backwards 
(-nn), forwards (+nn), the current page (CUR, the 
default value), or the beginning of the output (BEG). 


if 1, the output is considered as being frozen; if 0 
(default), it is considered as being held. 


(for a frozen output only) if 0, the banner at the 
beginning of the report is not printed; if 1 (default), it 
is left as it is. 
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Rules 


e FROM may be used only if STRONG is 1. 
e BANNER may be used only if STRONG is 1. 
e FROM = -nn cannot restart printing more than 8 pages back. 


Examples 


RTO R1234 {release the held output with name R1234} 


RTO R2345 STRONG FROM=BEG 
{restart the frozen output R2345 from the beginning} 
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8.4.6 RESYNC_MIRROR_SHARED (RSCMIR) 


Purpose 


Re-synchronizes on system B all shared mirrored disks after a crash on system A, 
A and B being coupled through mirrored disks in dynamic sharing. 


This command is available only if the system has been configured with MIRROR = 
YES. 


Syntax 

{ RESYNC_MIRROR_SHARED } 
{ RSCMIR } 
Parameters 


None. 


Rules 


RSCMIR is to be used in coupled systems environment with dynamic sharing of 
volumes after a crash on one of the two coupled systems. 
RSCMIR is mandatory prior to MDV CLEAR on any MIRROR SHARED volume. 


Refer to Mirror Disks User's Guide. 


Example 
RSCMIR displays the messages: 


MRO2 RESYNCHRONIZATION OF volnml dvc 
SUCCESSFUL 

MRO2 RESYNCHRONIZATION of volnm2 dvc 
SUCCESSFUL 

MRO4 RESYNCHRONIZATION OF SHARED 
VOLUMES COMPLETED 
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RELEASE_USER_REQ (RUR) 


Purpose 


Cancels the effects of the HOLD_USER_REQ command by making file transfer or 
jobset requests eligible for execution. 


Syntax 


{ RELEASE USER_REQ } 
{ RUR } 


REQUEST = (name8 [name8] ...) 


[START = dec5] 


Parameters 


REQUEST a list of up to 16 names of requests to be released. 
Each name may take one of the following three forms: 


— Jnnnnnnn: a Jobset Occurrence Number (JON) 


— Fnnnnnnn: a File transfer Occurrence number 
(FON) 


— name8: the symbolic name of a request, as specified 
by the NAME parameter of the ENTER JOB REQ 
or ENTER _FILETRANS REQ commands. 


JONs and FONs are provided as results of the 
ENTER JOB REQ and ENTER FILETRANS REQ 
commands. They are unique identifiers for the 
corresponding requests. 


START (meaningful only for file transfer requests) the rank of 
the logical record (starting with 1) from which the 
transfer is to be resumed. 
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Rules 


START is ignored for jobset requests. 


Examples 
RUR J66 {release one jobset} 
RUR (F4 J7 FREQ) {release three requests} 


RUR F33 START=600 _ {release file transfer and restart at record 600} 
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8.4.8 REPLY (REP) 
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Purpose 


Provides a reply to a deferred reply question. 


Syntax 
{ REPLY } 
{ REP } 
QID = dec2 
[ { mssc } ] 
[ { } = char160 ] 
[ { Msc } ] 
[ { SYSTEM } ] 
pf } = name4 ] 
[ { sys } ] 
Parameters 
QID the identifier of the question to which the reply 
applies. It is the two-digit number which is set in front 
of the text of the question. 
MSSG the text of the reply; when omitted, a blank reply is 
assumed. 
SYSTEM This parameter indicates the system where the 
command is executed. 
Rules 


QID must be the identifier of a deferred reply question that was addressed to the 
terminal user (not to another person) and that has not yet been replied to. 
Examples 
REPLY 12 YES {reply to question 12} 


REP 13 'A=3,B=7,k=8'! 
{reply to question 13} 


REP 15 {reply blank to question 15} 
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8.5 "S" Commands 


8.5.1 SEND 


Purpose 


Directs a message to a user's mailbox, to the log file, or to the terminal. 


Syntax 


SEND 


Parameters 
MSSG 
DEST 
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the text of the message to be forwarded. 
the destination of the message is as follows: 


name: the name of the person to whose mailbox the 
message is directed. The person may be currently 
logged on to the system or not. If no such person is 
registered in the system catalog. ME is assumed. 


ME: _ the message is printed on the terminal. 


LOG: the message is registered in the IOF log file. 
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Rules 
None. 
Examples 
SEND 'Hello Joe !' JSMITH 
{Send message to user JSMITH. } 
SEND OK {Write on terminal. } 


SEND 'POINT 3' LOG {Write to log file.} 
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8.5.2 SEND _ERROR_LOG (SNDERLOG) 


Purpose 


Enters a text in the SYS.ERLOG file. 


Syntax 


{ SEND _ERROR_LOG } 
{ SNDERLOG } 


} = char255 


Parameters 


MSSG the text of the message to be entered. 


Rules 


None. 


Example 


SNDERLOG ‘all disk counters reset after repair' 


NOTE: 


The message can be retrieved later by a DISPLAY ERROR _ LOG command. 
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Purpose 
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Initializes and enables the ASM 7 File Migrator (ARS). 


Syntax 

{ START ARS } 

{ ae, 
{ SARS } 


Parameters 


None. 


Example 


SARS ; 


Activates the ARS facility. 
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8.5.4 START_CLC (SCLC) 


Purpose 
Starts the Cartridge Library Client (CLC) component 


The CLC contributes to the automation of the mount/dismount operations for 
cartridge tapes. It intercepts requests for library cartridge services and transmits 
them to the Cartridge Library Server (CLS). 


The CLC and CLS are connected by a communications link. The CLC becomes 
operational when the link with the CLS is established. The CLC, CLS and 
Telecommunications Server may be activated in any order. 


Mount requests issued before the CLC is activated or during its initialization are 
automatically processed when the CLC becomes operational. 


Syntax 


{ START CLC } 


{ } 


{ SCLC } 


Parameters 


None. 


Rules 


None. 


Example 


SCLC {Start the Cartridge Library Client component. } 
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8.5.5  START_CLX (SCLX) 
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Purpose 


Activates the CLX service. 


Syntax 


{ START_CLX } 
{ SCLX } 


LIBRARY = <library name> 


SUBFILE = <subfile name> 


Parameters 

LIBRARY name of the GCOS 7 source library containing the 
CLX configuration file. The default value is 
CLX.SLLIB. 

SUBFILE name of the subfile containing the CLX configuration 
file. The default value is CLX_CONFIG. 

Example 


S: START CLX 
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8.5.6 START_CMSR (SCMSR) 


Purpose 


Starts or restarts a CMSR (Complex Management Server) that was not started at 
initialization, or that has aborted or was terminated by the TERMINATE CMSR 
command. Note that CMSR is normally started automatically by JOBM at GCOS 7 
initialization if the ISL option HA is active. This command is a part of the High 
Availability product (HA). For more information, see the High Availability 
Administrator's Guide. 


Syntax 

{ START _CMSR } 
{ SCMSR } 
Parameters 


None. 


Rules 

The CMSR must have been terminated 

The GCOS 7 system on which the CMSR is to run must have been started. 
This command must be submitted on the member where the CMSR is to run. 


If the CMSR was stopped by the TERMINATE _CMSR command with the FORCE 
parameter set, the servers that were running restart automatically after a 
START_MEMBER command. 


Example 


SCMSR {start or restart the CMSR that was terminated. } 
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START_CONSOLE_LOG (SCLOG) 


Purpose 


Starts or restarts the logging of the operator console into the SYS.LOGC file. This 
command is to be used only under Service Center supervision. 


{ START CONSOLE LOG } 
{ SCLOG } 


[CLEAR = { bool | 0 } ] 


Parameters 

CLEAR If 1, the SYS.LOGC file is cleared before the logging 
is restarted. 
The default value is 0. 

Rules 


Two SCLOG commands must not be executed simultaneously from two consoles. 
The SCLOG CLEAR command must not be executed while the PRLOGC utility is 
being executed. 


Examples 

SCLOG {Restarts the logging of the operator console without 
erasing the SYS.LOGC file contents. } 

SCLOG CLEAR {Erases the contents of the SYS.LOGC file and 


restarts the logging. } 
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8.5.8 START_DEVICE (SDV) 


Purpose 


Indicates to the system that a disk drive or cartridge device has been set to WRITE 
PERMIT as a reply to a request to do so. 


Syntax 
{ START DEVICE } 
{ SDV } 
{ DEVICE } { MSxx } 
{ } = { CTxx } 
{ DV } { } 
Parameters 
DEVICE the identification of the disk drive or cartridge device 
that has just been set to WRITE PERMIT. The activity 
which was temporarily blocked because the disk or 
cartridge was in WRITE PROTECT is resumed. 
Rules 
None. 
Examples 
SDV MS03 {Disk drive MS03 has been set to WRITE PERMIT. } 
SDV MS11 {Disk drive MS11 has been set to WRITE PERMIT.} 
SDV CTB1 {Cartridge unit CTB1 has been set to WRITE 


PERMIT} 
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8.5.9 START_DEVICE_TRACE (SDVTR) 


Purpose 


Asks for the logging in the SYS.ERLOG file and/or the displaying of the AV17 
debugging message (See Note 5 below) each time an event occurs for a device, a 
range of devices or devices of a certain class. The effect of this command can be 
reversed by the TERMINATE DEVICE TRACE command. 


Syntax 


{ START DEVICE TRACE } 
{ SDVTR } 


[ { DEVICE } { * 
[ = { dvtyp [dvnm] } 
[ 


— 


DV { dve 

[ { WARN } ] 

[ LOGLEVEL = { }] 

[ { DETAIL } ] 

[ { DISPLAY _ATN } ] 

bf } = bool ] 

[ { DATN } ] 

[ { DISPLAY WARN } ] 

[ { } = bool ] 

[ { DWARN } ] 

[ { DISPLAY ABN } ] 

[ { } = bool ] 

[ { DABN } ] 

Parameters 
DEVICE the device(s) for which the trace is to be started, 

expressed as: 
* all devices, 
dvnm a specified device, 
dvtyp all devices of a type, 
dvc all devices of a class. 


When omitted, all devices (*) are assumed. 
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LOGLEVEL 


DISPLAY _ATN 


DISPLAY WARN 


DISPLAY ABN 


Rules 


specifies the types of events to be logged in the 
SYS.ERLOG file. 


If WARN, only I/O errors and warnings are logged. 


If DETAILED, error logging is forcibly started each 
time peripheral error handling software is called. 


When this parameter is omitted, the current level of 
logging is not modified; 


If a previous SDVTR command was issued with 
LOGLEVEL=DETAILED option, that option is 
retained and is unchanged by the TDVTR command, 


if 1, logged events that are attentions are displayed. 


if 1, logged events that are normal terminations with 
marginal conditions are displayed. 


if 1, logged events that are abnormal terminations are 
displayed. 


When no parameter or only DEVICE is specified, then DISPLAY _ATN=1 and 
DISPLAY _ABN=!1 are assumed. 


Examples 


SDVTR 


SDVTR 


SDVTR 


SDVTR 


SDVTR 


SDVTR 


SDVTR 


MT 


MS/B10 


MT0O3 
DWARN 


MT04 DWARN 


{Start displaying ATN and ABN for all devices. } 
{Start displaying ATN and ABN for all tapes. } 


{Start displaying ATN and ABN for all MS/B10 
disks. } 


{Start displaying ATN and ABN for tape unit MTO3. } 
{Start displaying WARN for all devices. } 


{Start displaying WARN for tape unit MT04.} 


MS DETAILED DABN=0 


{Force error logging for all disk devices without any 
display. } 
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NOTES: 


1. The display options (DATN, DABN, DWARN) of the SDVTR command 
are cumulative; their effect is cancelled by the corresponding TDVTR 
command only. 


2. Display options are recorded in the SYS.ERLOG file for each device and 
remain in effect from one GCOS 7 session to the next. However, the 
LOGLEVEL is always reset to standard at the end of a GCOS 7 session, 
whether the termination is normal or abnormal. 


3. Display options, especially with the LOGLEVEL=DETAILED option, 
may cause an overload of messages; it is advisable to issue a SDVTR 
DABN=0 command to stop these message displays and to retrieve logged 
events later either by using the DISPLAY ERLOG command or by 
running the PRLOG utility. 


4. Using LOGLEVEL=DETAILED for numerous devices may cause the 
SYS.ERLOG file to be saturated early in the GCOS 7 session; this causes 
the first events logged to be lost. It is recommended to change this 
LOGLEVEL=DETAILED option as soon as the necessary information is 
available to identify the existing problem. 


5. The AV17 message is specifically for the purpose of debugging. It is only 
sent to the main console that activated the trace. The debugging 
information in this message is recorded in SYS.ERLOG and not 
SYS.LOGC. The information can be recovered from SYS.ERLOG with 
the DERLOG command or the PRLOG utility. 
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8.5.10 START_DYNSAVE_SVR (SDYNSVR) 


Purpose 


Starts the S-class dynamic save service job on the multi-process server. 


Syntax 

{ START _DYNSAVE_ SVR } 
{ SDYNSVR } 
Parameters 


None. 


Rules 
It may be refused with the message : 
"A TERMINATE OR START COMMAND IS ALREADY ACTIVE" 


if it is launched at the same time as the commands indicated by the message 
(TDYNSVR, SDYNSVR). 


Exceptionally an abnormal state of type 0 resources may produce the reply: 


"TYPE 0 RESOURCES FOR DYNSAV NOT CREATED" 

or 

"TURBOCONFIG.DYNSERVO=value" 

"NOT READY TO ACTIVATE SERVER (DYNSERVO NOT=01)" 


Example 


SDYNSVR {Requests start of the S-class dynamic save service job 
on the multi-process server. } 
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8.5.11. START_ERROR_LOG (SERLOG) 


Purpose 


Starts logging events in the SYS.ERLOG file. This command is to be used only 
under Service Center supervision. 


{ START _ERROR_LOG } 
{ SERLOG } 


[ CLEAR = bool ] 


Parameters 

CLEAR if 1, the SYS.ERLOG file is cleared before the logging 
is restarted. 

Rules 

None. 

Examples 

SERLOG {Restart logging. } 

SERLOG CLEAR {Restart logging after clearing SYS.ERLOG} 
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8.5.12 START_INPUT_READER (SIR) 


Purpose 


Specifies that job readers started after an EJR command, remain active during the 
whole session. This saves time when jobs are started. The command acts as a 
flip/flop with the TERMINATE INPUT READER command. (If you want to 
modify the number of readers on the site, use MODIFY _DJP command). 


Syntax 


{ START _INPUT_READER } 
{ SIR } 


PERM = bool 


Parameters 


PERM This parameter must be set for the command to be 
effective. 


Rules 


None. 


Example 


SIR PERM {After this command is entered, any job reader started 
by an EJR command remains active. } 
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8.5.13 START_IO_CACHE (SIOC) 


Purpose 


This command starts the GCOS 7 disk I/O Cache facility. It remains active until a 
TERMINATE JO CACHE or a system shutdown occurs. See the Large Memory 
Cache User's Guide for details. 


Syntax 

{ START _IO_ CACHE } 

{ sIoc } 
[{ SIZE} {4 }] 
La }= { } 1 
[{ sz }  { deca } ] 


[ SILENT = { bool | 0 } ] 

} ] 
} = { CACHE | SIMUL | REGUL } ] 
} ] 


[ { DEFAULT } ] 
[ { } = { FORCE | BYPASS } ] 
{ DFLT } ] 


Parameters 


SIZE Initial cache size in megabytes. The minimum size is 4 
Mbytes or the size of the dedicated I/O cache memory 
(if this exists). The maximum size depends on the 
DPS 7000 model and is computed as follows: 


80%x (TOTAL SIZE - DEDICATED I/O CACHE SIZE) 
- 20 Mbytes (*) 
+ DEDICATED I/O CACHE SIZE 


(*) 20 Mbytes is an average size for GCOS 7 systems. 


If the MIRROR DISKS function is active, the I/O 
Server service job is already started with a 4 MB cache 
memory. This parameter may be used to increase the 
cache size. 


SILENT If 0, the information and the error messages are sent. If 
1, only error messages are sent. 
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MODE Specifies the operating mode: 


If CACHE (default), the cache memory is physically 
allocated and normal cache processing begins. 


If SIMUL, cache processing is simulated but cache 
memory is not physically allocated. 


If REGUL, files with low hit ratios are dynamically 
excluded from the cache processing. 


DEFAULT When DEFAULT=FORCE (default) all files are 
cached, except those whose catalog descriptions or file 
assignment parameters specify otherwise. 


When DEFAULT=BYPASS no file is cached unless its 
catalog description or file assignment parameters 
specify otherwise. 


Rules 


This command is reserved for the main operator or the system administrator. 


Examples 


sIoc {Start the GCOS 7 I/O Cache facility with an initial 
size of 4 Mbytes} 


Dedicated cache not supported: 


SIOC SZ=12 {Start the cache facility with an initial size of 12 
Mbytes} 


Dedicated cache of 256 Mbytes supported: 


SIOC SZ=32 {Start the cache facility with an initial size of 256 
Mbytes (all in dedicated cache memory).} 


SIOC SZ=300 {Start the cache facility with an initial size of 300 
Mbytes (256 Mbytes in dedicated cache memory and 
44 Mbytes in standard memory).} 
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8.5.14 START_LOAD (SLD) 
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Purpose 


Enables jobs of specified classes to be selected for execution, creates new job 
classes, starts/stops job tracing. 


Syntax 

{START LOAD} 

{SLD } 
{CLASSLIST} {* }] 
[{ p= { }] 
[{CLASS } {aa[-aa] }] 
[JTRACE = {bool]0}] 
[{MULTI_LEVEL} ] 
[{ } = dec3] 
{MULTI } ] 
[{ PRIORITY} ({ * } { * })] 
[{ } = ({0]2]2/3]4]5]6]7}, (0]1]2/3|4]5]6|7/8]9})1 
{prety } ({ } { })] 
{PRIORITY LIMIT}  ({ * } { * })1 
{ } = ({0[2[2/3|4]5]6/7}, {0]1]2/3]4]5]6|7/8/9})1 
{PRTYLIM } ({ )] 


MDMULTI = bool] 


{SYSTEM} 
{ } = name4] 
{sys } 
Parameters 
CLASSLIST the class or range of classes to start, expressed as: 
* = all classes 
aa =a specified class 
aa[-aa] =a specified, inclusive range of classes 
JTRACE If 1, every step of every job is traced. 
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MULTL LEVEL multiprogramming level for each one of the selected 
classes. The range is from 0 to 255. 


PRIORITY Priority for the selected class(es) expressed as a pair of 
digits. There are (spr) scheduling priority and (xpr) 
execution priority. The lower the number, the higher 
the urgency. If * (default) the system assigns a default 
value to the corresponding priority. 


PRIORITY LIMIT sets limits to PRIORITY values, expressed as a pair of 
digits as follows: 


spr limit, xpr limit 
If * (default), the system assumes PRIORITY values. 


MDMULTI If 1, enables MULTL LEVEL to be modified later. If 0, 
MULTL LEVEL cannot be modified. 


SYSTEM This parameter indicates the system where the 
command is executed. 


Rules 


e CLASSLIST or JTRACE=1 must be used, but not simultaneously. 


e MULTI LEVEL, PRIORITY, PRIORITY LIMIT and MDMULT] are only 
meaningful when CLASSLIST=aa [-aa]. 


e When CLASSLIST is not used and JTRACE=0, the command is ignored. 


e When anew CLASS is created you must issue a second SLD command to start 
it, since new classes are in the NSTART state (see example below). 


Examples 

SLD * {Start all classes. } 

SLD AA MULTI=2 {Create class AA, then start it.} 

PRTY=(2,2) MDMULTI 

SLD AA 

SLD AA-QZ {Start classes AA to QZ. The classes were created by a 
previous SLD command. } 

SLD JTRACE {Start job tracing. } 
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8.5.15 START_MEMBER (SMB) 
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Purpose 


This command starts a single Member, several Members or the whole Complex. 
This command is a part of the High Availability product (HA). For more 
information, see the High Availability Administrator's Guide. 


Syntax 
{ START MEMBER } 
{ SMB } 
{ MEMBER }_ { * } 
{ p= { } 
{ MB } { ( name4 [ name4 ] ) } 
Parameters 
MEMBER List of the MEMBERS to be started; the star (*) starts 
all the MEMBERS of the Complex. 
Rules 


e The CMSR of the MEMBER on which this command is entered must be 
running. 


e This command cannot be submitted between the messages "CMSR 
RESYNCHRONIZATION IN PROGRESS" and "END OF CMSR 
RESYNCHRONIZATION". 


e The MEMBERS must be described in the COMPLEX description. 
e The MEMBERS must have been terminated. 
e The GCOS 7 system on which the Member is mapped must be started. 


e The CMSR of the MEMBER on which this command is entered must be able to 
communicate with the CMSR of the MEMBER to be started, i.e. no telecom 
failure or crash. 


Examples 
SMB MB=* {Start the whole COMPLEX.} 
SMB MB=MB1 {Start the MEMBER named MB1.} 
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8.5.16 
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START_OUTPUT_WRITER (SOW) (SO) 


Purpose 


Starts a writer on a specified device or file for specified output classes. When used 
by a station operator, this command starts a remote writer which sends to a station 
the outputs queued for it. 


Syntax 


{ START _OUTPUT_WRITER } 


{ SOW 


{ so 


ON 


Coal 


anes 


} 
} 


ALLDV } 
PRxx } 
name4 } 
$site:SPOOL } 


{ 
{ 
= { 
{ 


SELCLASS = 


{ DEVCLASS } { 
} = { PR [/dvattr] } 


— 


DVC } 
STATION } 
} = stnm 
ST } 
[ PERM = bool ] 
{ DOF } ] 
{ SARF} ] 
[ DATAFORM = { VPF } ] 
{ ASA } ] 
{ SSF } ] 


LCASE = bool ] 
USER = user [ PASSWORD = password ]] 
PROJECT = project ] 


BILLING = billing ] 
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[ JOR = NORMAL | ABORT | NO ] 
[ BANNER WIDTH = banner width] 
[ SILENT = bool ] 


[OPTIMIZE = bool ] 


Parameters 


ON 


on which device or file the writer is to be started, 
expressed as: 


ALLDV: all devices 
PRxx: the named printer 
named: the station's logical device identification 


$site: SPOOL the standard SYSOUT file of the named 
site 


rfile78: the named local or remote (GCOS 7 or DPS 6) 
file. 


rfile78 defines a local or remote file name. Syntax is: 
[SSITE:] file-name. When defining a foreign system 
file (DPS 6), the file-name must be protected by ''. 
When defining a DPS 7000 file, the file-name format 
is: efn [..subfile][:media:dvc]. As file-name is not a 
file-literal, $CAT/SRES or $MFT, etc., are not 
supported. 


An operator responsible for a queued writer (see the 
Generalized Terminal Writer User's Guide) can 
arrange for automatic submission of a job at the end of 
output processing (when the subfile in the library is 
closed). This job is conventionally called 
JCL_CONTROL and must be present in the library. 


For remote operations refer to the DPS6 - DPS7 
Remote Facilities Manual or the DJP User's Guide or 
the RBF User's Guide. 


If you are using a library, this library must not be 
cataloged in SITE.CATALOG. 
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SELCLASS 


DEVCLASS 


STATION 


PERM 


DATAFORM 


LCASE 


USER 


PASSWORD 
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restricts the scope of the command to the outputs that 
belong to the specified class(es) or range(s) of classes. 
This may be expressed as: 


class for a single class 
class-class for a range of classes 


where class is a letter (A to Z). When SELCLASS is 
omitted, "default classes" attached to the device are 
assumed. In the case of SOW on SPOOL or rfile78, 
"all classes" are assumed. 


(for sequential files) the device to be simulated for 
presentation of the report on the file. The file can be 
later processed by use of the DPRINT command. 


Name of the (unattended or rescued) station to which 
the command applies. 


(applies only to local writers) when 1, the writer is 
permanent. The default value is 0. 


The data format for the output handled by the writer. 
One of the following can be entered: 


DOF Device Oriented Format 

SARF Standard Access Record Format 
VPF Virtual Printed Format 

ASA American Standard Assn. format 
SSF Standard System Format 


This parameter is meaningful only for the Writer 
Queued product. 


(for DPS 6 stations) when 1, the remote writer is 
requested to keep lowercase when printing. 


Name of the user to be connected to the remote site. 
Default is the command submitter. 


Password of the user to be connected to the remote 
site. Default is the password of the command 
submitter. 
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PROJECT 


BILLING 


JOR 


NORMAL 
ABORT 


NO 


BANNER WIDTH 
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Project of the user to be connected to the remote site. 
Default is the project of the command submitter. 


If BILLING only is specified (that is, USER / 
PASSWORD / PROJECT not specified), PROJECT is 
left blank to enable connection to a remote site with 
the default project of the user on the remote site 
(EFTR rules). 


Billing of the user to be connected to the remote site. 
Default is the billing of the command submitter. 


If PROJECT only is specified (that is, USER / 
PASSWORD / BILLING not specified), BILLING is 
left blank to enable connection to a remote site with 
the default billing of the specified project on the 
remote site (EFTR rules). 


Specifies whether the JOR is to kept or not on 
termination of the writer. 


the JOR is kept in all cases, 

the JOR is kept only in the event of abnormal 
termination, 

the JOR is not kept in any circumstances. 


The default value depends on the type of writer: 
Local magnetic writers: NORMAL 
Other writers: NO. 


This parameter is meaningless for SPOOL. 


Specifies the banner width (in number of columns) of 
output when it is printed. The default and upper value 
is 120; the lower value is 55. 


The BANNER WIDTH parameter value in the SOW 
command takes into account the possible 
characteristics of the banner as follows: 


— small banner if BANNER WIDTH is between 55 
and 107, 


— big banner with big letters separated by 1 blank if 
BANNER_WIDTH is between 107 and 118, 


— big banner with big letters separated by 2 blanks if 
BANNER_WIDTH is between 118 and 120. 
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The BANNER WIDTH parameter value in the SOW 
command also takes into account the format of the 
paper mounted on the printer. If the paper cannot 
accommodate the requested format, the printed banner 
width is the maximum possible. 


SILENT This parameter deletes the messages TW04, TW05 and 


TW06 sent by GT-WRITER. This parameter is 
significant only in the case of a queued writer launched 
on the station GTW. The default value is SILENT = 0. 
Example 


SOW SMAIN :library STATION=GTW 
SILENT=1. 


OPTIMIZE The implementation of this parameter modifies the 


selection mechanism of the outputs by the writer. The 
outputs are still selected according to their priority, but 
within a priority, the writer will select first the output 
which does not require the mount of a new media. The 
default value is OPTIMIZE = 0. In this case, the 
outputs are selected by priority and FIFO within the 
priority. 

Example: 


SOW PRO1 SELCLASS=P OPTIMIZE=1. 


Rules 


DEVCLASS, PERM, LCASE and DATAFORM are ignored when ON is 
ALLDV. 


SITE is mandatory in the ON parameter if ON = RFILE and STATION is not the 
same as #WSTATION. 


When SITE is omitted in the rfile78 syntax, the default site of the station is 
assumed. 


SITE is mandatory in the rfile78 syntax if the SOW command is managing an 
output queue other than the default station queue. 


USER, PASSWORD, PROJECT and BILLING are meaningful only for remote 
writers or SPOOL. 


SOW command on an already started file can be used to add new classes 
(SELCLASS parameter) to the class list on which the writer has been launched. 
All parameters other than SELCLASS are ignored (and keep their initial values). 
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e Inthe case of SOW..SPOOL, selclass/devclass/STATION queue are added to the 
GTP selection criteria. Only the operator's right to submit SOW for that 
STATION is checked. 


e Ifa file situated on a remote site is used, this file must be sequential, and its 
RECSIZE must be greater than or equal to 600. 


e When a writer is started on a cataloged file, this file must pre-exist. The output 
writer will not create it. 


Examples 
SOW ALLDV {Starts all local writers on devices. } 
SOW PRL6 Z LCASE {Start a writer on the station's logical device PRL6 


SOW 


SOW 


SOW 


SOW 


with lower case handling. } 


OUTSAV :OUT :MT/T9 X DVC=PR/H160 
{All outputs of class X are saved on the named tape 
file, emulating a 160 hammers printer. } 


SSETI:MYFILE {Launches a Writer on the site SETI; the outputs are 
saved in the file MYFILE. } 


$BC03:SPOOL ST=BC03 USER=OP2 PASSWORD=OP 
{Starts a spool towards the remote site BCO3; user 
OP2 with password OP is connected to this remote 
site.} 


PRO1 BANNER _WIDTH=110 
The banner width of the outputs processed by this 
writer is 110 columns. 
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8.5.17 START_POWER_TIMER (SPWRTM) 


Purpose 


Starts the timer power control module (H_ TPC). 


Syntax 


{ START POWER TIMER } 
{ SPWRTM } 


Parameters 


None. 


Rules 
This command is not available on DPS 7000/2X0/3X0. 


Example 


SPWRTM {Requests start of the power timer. } 
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8.5.18 START_RMS (SRMS) 
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Purpose 
Enables the connection of a remote maintenance operator. 


Before this command is entered, the RMS operator's logon is submitted to a main 
operator for approval. 


Syntax 


{ START_RMS } 
{ SRMS } 


[ on = { Gcos | SP } ] 


[ { ENABLE | ENBL } = { PL | LC } ] 


Parameters 
ON Specifies the RMS type: 
GCOS functions on all DPS 7000 machines. 
SP indicates the RMS supported by the Service 
Processors DPS 7000/An and the 
DPS 7000/5x0/7xx/8x0/Dx0/Mx0 machines. 
ENABLE Designates the PL or the LC object when connecting 


under SP RMS: 


LC means the Logical RMS Connection. It is the 
default for the 
DPS 7000/2x0/3x0/5x0/7xx/8x0/Dx0/Mx0 machines. 


PL means the Physical RMS Line. It is the default for 
the DPS 7000/An. 


On the DPS 7000/5x0/7xx/8x0/Dx0/Mx0, the default 
object when connected through the Service Processor 
(SP), is LC. The LOCK parameter can be used to 
change the object to PL. 
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Rules 


e Except as explained above for the DPS 7000/5x0/7xx/8x0/Dx0/Mx0, an 
incompatible object causes the command to be rejected. 


e When ON=GCOS, if specified, ENABLE must be equal to LC. 


Examples 


SRMS 


{Starts a GCOS type RMS session. } 


SRMS ON=SP ENABLE=PL 


{Starts RMS giving the physical line (PL) the state 
ENBL (ENABLE) for the DPS 7000/An and the 

DPS 7000/5x0/7xx/8x0/Dx0/Mx0. The conditions are 
different for the two machines: 


— DPS 7000/An: the ENBL state is said to be 
LIMITED; it returns to state LOCK in 5 minutes. 


— DPS 7000/7xx/8x0/Dx0/Mx0: The ENBL state is 
unlimited; there is not time-out. 


The command is rejected if the PL state is ENBL and 
if the LC state is WAIT or USED.} 


SRMS ON=SP ENABLE=LC 
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{This command, used on the 
DPS 7000/5x0/7xx/8x0/Dx0/Mx0 , changes the LC 
state from WAIT to USED and validates the RMS 


session. } 
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START_SERVICE (SSRV) 


Purpose 
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Starts a SERVICE and also its USED SERVICES if they are not already started. 
This command is a part of the High Availability product (HA). For more 
information, see the High Availability Administrator's Guide. 


Syntax 


{ START SERVICE } 
{ SSRV } 


{ SERVICE } 
} 


SRV } 


RESYNC = { bool | 0} 


[ { OPTION 
C { 
LA 


OPT 


[ { MEMBER 


{ 
[ { MB 


] 
char240 ] 


] 


] 


( name4 [ name4 ] ) ] 


] 


[ { USED_SERVICE } ] 


C { 


[ { USRV 


Parameters 
SERVICE 
RESYNC 
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} = ( name8 [ name8 ]... ) 


} ] 


i 


Name of the SERVICE to be started. 


Used to restart SERVICEs in back up mode which had 
been started on the corresponding MEMBER during 
failure of the current MEMBER. 


To use RESYNC the following conditions must be 
met: 


— the corresponding MEMBER must be crashed, 
silent or telecom isolated. 


— the SERVICE to start must be HA. 
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— the BACKUP SERVER is started on the current 
MEMBER, which means, the MEMBER parameter, 
if it exists, must specify first the corresponding 
member, then the current member. 


OPTION A string of parameters specific to the type of 


SERVICE (TDS, ORACLE). 


MEMBER List of the MEMBERS on which the SERVICE must 


be started. Without this parameter, the SERVICE starts 
on the MEMBERS given in the COMPLEX 
generation. 


The SERVICEs are started in the order given here. 
This is useful to be able to start the SERVICE in 
ACTIVE mode on a MEMBER other than the 
preferential ACTIVE MEMBER. 


If this parameter is given and the SERVICE to start is 
HA, there must be two MEMBERS listed, because 
an HA SERVICE must be completely started, i.e. on 
both MEMBERS specified on its mapping. 


USED_SERVICE This parameter is used to designate specific 


USED_SERVICEs to be started if all are not to be 
started. 0 to 16 services can be designated. By default, 
these services are declared at generation of the 
complex. 


Rules 


The CMSR of the MEMBER on which this command is entered must be 
running. 


This command cannot be submitted between the messages "CMSR 
RESYNCHRONIZATION IN PROGRESS" and "END OF CMSR 
RESYNCHRONIZATION". 


The SERVICE and also the USED_SERVICEs and the MEMBERs must be in 
the COMPLEX description. 


The specified MEMBERs must belong to the SERVICE mapping. 
The MEMBER parameter must give two MEMBERs. 


The specified USED_SERVICEs must have been declared as used by the 
SERVICE at COMPLEX generation. 


The SERVICE must not be started. 
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The MEMBER, on which this command is to start the SERVICE in ACTIVE 
mode, must have been started with the START MEMBER command. 


If some of the USED_SERVICEs of the SERVICE to start are already running, 
their ACTIVE SERVER must be running on the same MEMBER as that where 
the SERVICE is to start in ACTIVE mode. 


A TDS HA can be started only if all the JAS HA of the COMPLEX can be set in 
the SWITCHABLE mode. Therefore, if the MEMBERs are UNSWITCHABLE, 
a switchability modification of all the MEMBERS must be done; however, this 
is impossible if the "co-Member is telecom isolated or if there is already a 
running TDS non-HA SERVICE using a JAS SERVICE. 


If a telecom isolation occurs during the SWITCHABILITY modification, the 
command is abandoned. 


A TDS non-HA using a JAS HA can be started only if all the JAS HA of the 
COMPLEX « can be set in the UNSWITCHABLE mode. 


If there is an isolation or crash of the ACTIVE MEMBER, the CMSR rejects the 
command. 


If one of the USED_SERVICEs of this SERVICE refuses to start on the 
ACTIVE MEMBER, the SERVICE is not started. 


Examples 


SSRV SRV=TDS1 {Starts the SERVICE named TDS1 on all the 


MEMBERS specified in its description and also starts 
all the USED_SERVICEs of TDS1.} 


SSRV SRV=TDS1 MB=(MB2 MB1) 


{Starts the SERVICE named TDS1 on all the 
MEMBERS specified in its description, but with the 
ACTIVE SERVER running on MB2; also starts all the 
USED_SERVICEs of TDS1.} 


SSRV SRV=TDS1 USRV=BLUE 


{Starts the SERVICE named TDS1 on all the 
MEMBERs specified in its description and also starts 
only its USED_SERVICE BLUE. } 
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8.5.20 START_SSI (SSSI) 


Purpose 


To activate the CLX processes (ssi, acsel) on OPEN 7. 


Syntax 

{ START SSI } 
{ SSSI } 
Parameters 


None 


Rules 


To use this command, OPEN 7 must be active. 


Example 


S: START SST 

11.16 X550 IN CLX SSI USER=OPERATOR CLASS=P SPR=6 STATION=BCA9 
11.16 X550 STARTED CLX SSI OPERATOR P 

JB0O8 X550.1 STEP H CLX CMDSSI XPR=8 PGID=22 

TU70 ACSEL AND SSI STARTED 

11.16 X550.1 COMPLETED CLX SSI OPERATOR P 
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8.5.21 START_SYSTEM_TRACE (SSYSTR) 


Purpose 


SSYSTR starts the system trace collector service job, starts domain trace activity in 
defined classes, starts domain wait mode for trace event requests and links domains 
to named buffers. 


NoTE: 
This command is hidden and is to be used only under the direction of a Bull 
support engineer. 


Syntax 


{ START SYSTEM TRACE } 
{ SSYSTR } 


[ { DOMAIN } { ALL }] 
[{ DM }={* fol 
[ { Toom }  { star63 } ] 


[ CLASS={NOR|DET|TRM| INR |IDT|CND|DTV|ABN|ARC|TRP|TDP|ALL}] 


{ WHERE } { FILE } 
{ b= { ; 
{To } { MEM } 
[ { BUFFER } ] 
[ { } = nameé |] 
[ { BFR } ] 


[ WAIT = bool ] 


[ { COLLECTOR } ] 
[ = bool ] 
[ { CLTR } ] 
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Parameters 


DOMAIN 


CLASS 


WHERE 


BUFFER 


WAIT 


COLLECTOR 


Rules 


It is the name of a system trace domain or, if ALL or 
"*" Is specified, all domains. Maximum length is 63 
characters. 


It is either ALL (the default, meaning all classes) or a 
system trace class name. Correct values are: NOR, 
DET, TRM, INR, IDT, CND, DTV, ABN, ARC, TRP, 
and TDP. 


This specifies the required domain class state, FILE or 
MEM. MEM is the default. 


It is the name of the system trace collector buffer. 
Maximum length is 6 characters. 


If 1, the domain trace event WAIT attribute is 
specified; if 0, the WAIT attribute is not specified. 


If 1, the system trace collector service job is started; if 
0, the service job is not started. 


e The trace domain attributes WAIT, BUFFER, and CLASS, in FILE state, are 
meaningless before and after system trace collector execution. 


e MEM and closed state are equivalent to TDP class. 


e Domain start trace event in WAIT mode is effective only if the connected buffer 


has the WAIT attribute. 


e If COLLECTOR is specified no other parameter may be specified. 
e If COLLECTOR is not specified, the DOMAIN must be specified. 
e CLASS, BUFFER and WAIT are mutually exclusive. 

e WHERE, BUFFER and WAIT are mutually exclusive. 
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Examples 


SSYSTR DOMAIN=MYTDOM BUFFER=TRCB1 


{Connect the MYTDOM trace domain to buffer 
TRCB1.} 


SSYSTR DOMAIN=MYTDOM 
{Open all MYTDOM domain classes to memory trace 
events. } 


SSYSTR DOMAIN=MYTDOM WAIT 


{Enable WAIT mode for trace event requests issued for 
MYTDOM domain.} 


SSYSTR COLLECTOR {Start the system trace collector service job. } 
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8.5.22 START_TERMINAL_OUTPUT (STO) 


Purpose 


Starts the printing of outputs on a terminal or pool of terminals; modifies the class 
of outputs handled by a terminal. Only the owner of the object terminal or users 
declared as Master Operators for the Generalized Terminal Writer may use this 
command. Refer to the G7Writer User's Guide for a complete description. 


{ START TERMINAL OUTPUT } 
{ STO } 
{ TERM } 
} = namel12 
{ ™ } 
[SELCLASS = a[-a]] 


Parameters 

TERM the name of the terminal or pool of terminals where 
outputs are printed. 

SELCLASS specifies the class (SELCLASS = a) or range of classes 
(SELCLASS = a-a) of outputs that can be printed on 
the terminal or pool of terminals. If the terminal or 
pool is already started, the selected classes are added to 
the list of those that are eligible for printing on the 
terminal or pool. 

Rules 

None. 

Examples 

STO POOL3 {Start printing on terminal pool POOL3.} 

STO TERM3 A-Q {Start printing on terminal TERM3 for classes A 


through Q.} 
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8.5.23 START_TERMINAL_WRITER (STW) 


Purpose 


Starts one or all of the Generalized Terminal Writer drivers. Refer to the GT Writer 
User's Guide for a complete description of the Generalized Terminal Writer. 


Syntax 

{ START TERMINAL WRITER } 

{ STW } 
[{ ALL }] 


Parameters 

ALL The default parameter shuts down all the drivers. 

name4 This is the name of the driver to be stopped. When 
omitted, all drivers (ALL) are assumed. 

Rules 

None. 

Examples 

STW {Start all drivers. } 

STW TWO1 {Start driver TWO1.} 
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8.5.24 SWITCH_MIRROR (SWMIR) 


Purpose 


Reverses the roles of the Primary and Secondary disks of a mirror volume so that 
the Primary disk becomes Secondary and vice versa. 


This command is asynchronous. 


Syntax 


{ SWITCH MIRROR | SWMIR } 


{ VOL | VOLUME } = name6:dvc; 


Parameters 

VOLUME The id of the mirror volume in the form name: 
device-type (e.g. MIRV01:MS/FSA). 

Constraints 


The volume must not be allocated. 
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"T" Commands 


TAKEOVER_MEMBER (TKMB) 


Purpose 


The operator uses this command to force the TAKEOVER of all the SERVICES of 
a MEMBER in order to continue execution of the TDS, JAS and Oracle 
applications on the other MEMBER. This command is a part of the High 
Availability product (HA). For more information, see the High Availability 
Administrator's Guide. 


Syntax 
{ TAKEOVER MEMBER } 
{ TKMB } 

{ OPTION } 

} = { STRONG | FORCE | WEAK } 

{ OPT } 
Parameters 
OPTION Specifies the kind of TAKEOVER. 


WEAK: 

The ACTIVE SERVERs running on the co-MEMBER 
are switched into the BACKUP mode and the 
BACKUP SERVERS running on the current 
MEMBER are switched into ACTIVE mode. 


STRONG: 

Induces the crash of the co-MEMBER and the 
BACKUP SERVERs running on the current 
MEMBER are switched into the ACTIVE mode. This 
option requires a confirmation by the operator. If the 
operator does not answer in the affirmative, the 
command is abandoned. 
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FORCE: 

The operator must be sure that the co-MEMBER is no 
longer operational before ordering this kind of 
TAKEOVER. The BACKUP SERVERs running on the 
current MEMBER are switched into the ACTIVE 
mode. This option requires a confirmation by the 
operator. If the operator does not answer in the 
affirmative, the command is abandoned. 


Rules 
e The CMSR of the MEMBER on which the command is entered must be running. 


e This command must not be submitted between reception of the "CMSR 
RESYNCHRONIZATION IN PROGRESS" and the "END OF CMSR 
RESYNCHRONIZATION" messages. 


e The command must be entered on the MEMBER to be switched into the 
ACTIVE mode. 


e If OPTION is WEAK or STRONG, the two CMSRs must be operational, the two 
MEMBERS must have been started with the START MEMBER command and 
not be telecom isolated. 


e The command is rejected if entered with WEAK or STRONG while the CMSR 
required the FORCE OPTION. 


e If FORCE is used, the operator must check that the co-MEMBER is no longer 
running. 


e The TAKEOVER of the current MEMBER can only be executed if the 
MEMBER is SWITCHABLE and there are BACKUP SERVERs running on the 
current MEMBER. 


e If there is already a TAKEOVER in process, the command 1s accepted only if 
the OPTION is more important. STRONG overrides WEAK and FORCE 
overrides both. 


e If there is already a TAKEOVER in process, the command is rejected if the 
current TAKEOVER is almost finished. 


e The same kind of TAKEOVER must not already be in execution. 


e TAKEOVER with STRONG or FORCE is abandoned if the disk restore 
processing does not succeed. 


e Since TAKEOVER is for all SERVERS, if an ACTIVE or a BACKUP SERVER 
refuses to switch, the TAKEOVER is not given up but goes on to the other 
SERVICEs. 
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e Ifan ACTIVE SERVER refuses to switch to the BACKUP mode, CMSR 
automatically terminates this SERVER using FORCE. 


e Ifa BACKUP SERVER refuses to switch to the ACTIVE mode, then it remains 
BACKUP, but the CMSR, using FORCE, must terminate all the MAIN 
SERVERs which are using it on this MEMBER. 


Example 


TKMB {Switches the active SERVERS on the 
corresponding-MEMBER to BACKUP mode and the 
BACKUP SERVERS on the current-MEMBER to 
ACTIVE mode. } 


47 A2 53US 8-135 


GCOS 7 System Operator's Guide 


8.6.2 TERMINATE_ARS (TARS) 


Purpose 


Disables the ASM 7 File Migrator (ARS). Current Migration-in requests are 
allowed to complete, but no new dynamic Migration-in requests are accepted. 


Syntax 

{ TERMINATE ARS } 

{ } 

{ TARS } 

[ STRONG = { bool | 0} ] ; 

Parameters 

STRONG If 1, ARS is disabled immediately. All ASSIGNs 
waiting for a Migration-in to complete are aborted 
with the return code RC=FUNCNAV. The files 
concemed are restored but not assigned. 
If 0 (default), all ASSIGNs waiting for a Migration-in 
to complete are allowed to terminate normally. The 
files concerned are restored and assigned. 

Rules 


In no case does this directive interrupt file migrations already in progress. 


Examples 


TARS ; 
ARS is disabled. All ASSIGNs waiting for a Migration-in to complete are allowed 
to terminate normally. 


TARS STRONG; 
ARS is disabled immediately. All ASSIGNs waiting for a Migration-in to complete 
are aborted with return code RC=FUNCNAV. 
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8.6.3 TERMINATE_CLC (TCLC) 


Purpose 


Terminates the Cartridge Library Client (CLC) component. 


Syntax 


{ TERMINATE CLC } 
{ TCLC } 


STRONG = { bool | 0 } 


Parameters 
STRONG This parameter specifies the type of termination: 
0 CLC termination is rejected if some devices of 
the cartridge library are in use. 
1 CLC is terminated regardless of the device 
state. 
Rules 
None. 
Example 
TCLC {Normal CLC termination. } 
TCLC STRONG {Immediate CLC termination. Pending requests from 


Device Management and active requests to the 
Cartridge Library Server (CLS) are displayed on the 
console. } 
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8.6.4 TERMINATE_CLX (TCLX) 


Purpose 


Shuts down CLX on GCOS 7, either non-urgently or urgently. 


Syntax 


{ TERMINATE CLX } 
{ TCLX } 


[STRONG = { bool | 0 } ] 


[DUMP = bool ] 


Parameters 

STRONG requests an urgent shutdown. 

DUMP optionally allows you to request a dump in 
SYS.SPDUMP. 

Example 


TERMINATE CLX STRONG [DUMP] 

When TERMINATE CLX STRONG is entered, CLX displays the message: 
TU08 <clx version> CLX IMMEDIATE SHUTDOWN 

CLX then displays all interrupted requests in the following message format: 


TU39 <clx version> DVMGT OUTSTANDING REQUESTS: 
<request> <dev><vol><type><job> <msg-stat>-<cmd> IS <cmd-stat> 


CLX then issues the following message for all queued requests: 


TU38 <clx version> DVMGT PENDING REQUESTS: 
<request> <dev><vol><type><job> <msg-stat>-<cmd> IS <cmd-stat> 
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8.6.5 TERMINATE_CMSR (TCMSR) 


Purpose 


This command terminates execution of a CMSR on a Member. It is used by the 
Main Operator to activate CRCXGEN (Create Complex Generation) and the 
ENABLE parameter equal to 1, or in an abnormal situation. This command is a 
part of the High Availability product (HA). For more information, see the High 
Availability Administrator's Guide. 


Syntax 


{ TERMINATE CMSR } 
{ TCMSR 


FORCE = { bool | 0 } 


Parameters 

FORCE First causes execution of the TERMINATE MEMBER 
command with the FORCE parameter set on this 
command also, then terminates the CMSR. In this 
case, CMSR termination is effective even if there were 
still activated components on the Member. 

Rules 

If there are active components on the Member, the command is rejected without the 

FORCE parameter. 

Example 

TCMSR {terminates CMSR execution. } 
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8.6.6 | TERMINATE_CONSOLE_LOG (TCLOG) 


Purpose 


Makes the SYS.LOGC file unavailable to the system and terminates the logging of 
the current session. This command is to be used only under Service Center 


supervision. 

Syntax 

{ TERMINATE CONSOLE LOG } 
{ TCLOG } 
Rules 


Two TCLOG commands must not be executed simultaneously from two consoles. 
TCLOG must not be executed while the PRLOGC utility is being executed. 


Example 


TCLOG {Terminate operator session logging. } 
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8.6.7 TERMINATE_DEVICE_TRACE (TDVTR) 


Purpose 


Terminates the logging and/or the displaying of a message each time an event 
occurs for a device, a range of devices, or devices or a certain class. This command 
reverses the effect of a START _DEVICE_TRACE command. 


Syntax 

[ { TERMINATE DEVICE TRACE } ] 

[ { TDVTR }] 
[ { DEVICE } { * }] 
[ { } = { dvtyp [dvnn] } ] 
[ { Dv }  { ave }] 


coal 


LOG = bool ] 


DISPLAY ATN } ] 


a 
aan 


ww 
ll 
ley 
Q 
e) 
bh 


DATN 


DISPLAY WARN } ] 


al 

aan 

wwe 
wu 


DWARN 


DISPLAY ABN } ] 


DABN 


coal 
aan 


ww 
I 
ion 
e) 
@) 
pa 


Parameters 


DEVICE the device(s) for which the trace is to be terminated, 
expressed as: 


* : all devices, 

dvnm _ :a specified device, 
dvtyp : all devices of a type, 
dvec : all devices of a class. 


When omitted, all devices (*) are assumed. 


LOG if 1, the logging of events relating to the specified 
device(s) becomes standard. 
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DISPLAY _ATN 


DISPLAY WARN 


DISPLAY _ABN 


Rules 


if 1, events that are Attentions are no longer be 
displayed. 


if 1, events that are normal terminations with marginal 
conditions are no longer displayed. 


if 1, events that are abnormal terminations are no 
longer displayed. 


When no parameter or only DEVICE is specified, then logging becomes standard 
and no further events are displayed. 


Examples 


TDVTR 


TDVTR 


TDVTR 


TDVTR 


TDVTR 


TDVTR 


TDVTR 
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MS/B10 


MS03 


DABN 


{Terminate logging and displaying all events for all 
devices. } 


{Terminate logging and displaying all events for all 
disks. } 


{Terminate logging and displaying all events for all 
MS/B10 disks. } 


{Terminate logging and displaying all events for disk 
unit MS03.} 


{Terminate displaying attentions and normal 
terminations for all devices. } 


MSO03 DATN DWARN 


MS31 LOG 


{Terminate displaying attentions and normal 
terminations with marginal conditions for disk unit 
MS03.} 


{Return to standard logging for disk unit MS31.} 
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8.6.8 TERMINATE_DYNSAVE_SVR (TDYNSVR) 


Purpose 


Shuts down the server. 


Syntax 


{ TERMINATE DYNSAVE SVR } 
{ TDYNSVR } 


[ FORCE = { bool | 0 } ] 


Parameters 

FORCE The FORCE parameter shuts down the server and 
causes the immediate ABORT of all saves in progress. 

Rules 

The server may be shut down with or without the FORCE option (by default: NO 

FORCE). 

e FORCE=1 this option is only used in the following two cases: 
— all dynamic saves in progress must be terminated. 
— there is a system deadlock. 
In both cases, the FORCE option causes the immediate 
ABORT of the saves and shutdown of the server. A 
system deadlock is always cancelled by this command 
as it frees all semaphores on the server. 

e FORCE=0 (default value) this option shuts down the server only 


if there is no dynamic save in progress (and if the 
server 1s active). Otherwise shut down of the server 
will be refused with the following messages: 


"TERMINATE REFUSED:SAVE RUNNING" 
"USE TERMINATE FORCE OR RETRY AT 
SAVE END" 
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Example 
TDYNSVR 


BYA2: tdynsvr 
PLUG MESS4 


{Produces the display shown below: } 


TERMINATE SERVER STARTED 


PLUG MESS17 
BYA2: 


BYA2: tdynsvr 
PLUG MESS7 


NO FILE IS UNDER DYNAMIC SAVE (TERMINATE) 


TERMINATE SERVER ASKED AND SERVER NOT ACTIVE 


BYA2: 


8-144 


47 A2 53US 


Description of the Operator Commands (Part 2) 


8.6.9 TERMINATE_ERROR_LOG (TERLOG) 
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Purpose 


Terminate logging events in the SYS.ERLOG file. This command is to be used 
only under Service Center supervision. 


Syntax 

{ TERMINATE ERROR_LOG } 
{ TERLOG } 
Rules 


None. 


Example 


TERLOG {Terminate error logging.} 
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8.6.10 TERMINATE_INPUT_READER (TIR) 


Purpose 


Specifies that job readers, started after an EJR command, no longer remain active 
when they have finished reading the currently entered jobs. The command acts as a 
flip/flop with START _INPUT_READER. 


Syntax 


{ TERMINATE INPUT READER } 


{ TIR 


} 


PERM = bool 


Parameters 


PERM 


Rules 


None. 


Example 


TIR PERM 
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This parameter must be set for the command to be 
effective. 


{After this command is entered, job readers started by 
EJR command no longer remains active once they 
have finished reading. } 
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8.6.11 TERMINATE_IO_CACHE (TIOC) 


Purpose 


This command is used to terminate the GCOS 7 Input/Output Cache function. See 
the Large Memory Cache User's Guide for full details. 


Syntax 

{ TERMINATE IO CACHE } 
{ TIOoc } 
Parameters 


None. 


Rules 


None. 


Example 


TIOC (Termination of the GCOS 7 I/O Cache is requested). 
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8.6.12 TERMINATE_LOAD (TLD) 


Purpose 


Prevents jobs of specified class being selected for execution, deletes job class(s), 


starts/stops job tracing. 


Syntax 


{ TERMINATE LOAD } 
{ TLD } 


[ 

D4 
[ { CLASS 
[ JTRACE = { 
[ { DELETE } 
bs } 
[ { DL } 
[ { SYSTEM } 
; 


} 
[ { sys } 


Parameters 


CLASSLIST 


JTRACE 
DELETE 


SYSTEM 
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{ CLASSLIST } 


ad pul 
= { aa }] 
} { aa[-aa] } ] 
bool | 0 } J 


=f beel: | 0.4] 


the classes or range of classes to terminate, expressed 
as: 


* all classes, 
aa the specified class, 
aa-aa the specified inclusive range of classes. 


if 1, job tracing is stopped. Default is 0. 


deletes the class or range of classes specified. Default 
is 0. 


This parameter indicates the system where the 
command is executed. 
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e CLASSLIST or JTRACE=1 must be used, but not simultaneously. 
e DELETE must not be | when CLASSLIST=*, and is meaningless when 


JTRACE=1. 


e DELETE is only available where there is no job in the class specified. If this is 
not the case, introduce the command later. 


e when CLASSLIST is not used and JTRACE=0, the command is ignored. 


Examples 
TLD * 
TLD QZ 


TLD AA-QZ 


TLD AA-AD DELETE 


{Terminate all classes. } 
{Terminate class QZ. } 
{Terminate classes AA-QZ.} 


{Delete classes AA,AB,AC,AD. } 
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TERMINATE_MEMBER (TMB) 


Purpose 


Stops a single MEMBER, several MEMBERS or the whole COMPLEX. This 
command is a part of the High Availability product (HA). For more information, 
see the High Availability Administrator's Guide. 


Syntax 

{ TERMINATE MEMBER } 

{ TMB } 
{ MEMBER} { * } 
{ b= { 
{ MB } { ( name4 [ name4 ] } 


[ FORCE = { bool | 0 } ] 


Parameters 


MEMBER List of the MEMBERS to be terminated. The asterisk 
(*) terminates all MEMBERS of the COMPLEX that 
have no administered SERVICES running on them. 


FORCE The FORCE parameter terminates the MEMBERS 
immediately even if there are SERVERS still active on 
these MEMBERS. The JAS SERVICES are also 
considered terminated even if there are batch jobs 
using them. If these jobs are being journalized they are 
aborted; if not, the operator uses the DISPLAY JAS 
command to identify them, then the CANCEL JOB 
command to terminate them manually. 


Rules 
e The CSMR of the MEMBER on which the command is entered must be running. 


e This command must not be submitted between reception of the 
"RESYNCHRONIZATION IN PROGRESS" and the "END OF THE 
RESYNCHRONIZATION" messages. 


e The MEMBERS must be described in the COMPLEX description. 
e The MEMBERS must have been started. 
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e The CMSR of the MEMBER on which this command is entered must be able to 
communicate with the CMSR of the MEMBER to be terminated (MEMBER not 
isolated and not crashed). 


e If there are SERVICES running on a MEMBER, TMB, without the FORCE 
parameter, is rejected for that MEMBER . 


Examples 
TMB MB=* {Terminates the whole COMPLEX} 
TMB MB=MB1 {Terminates the MEMBER named MB1 if there are no 


more SERVERS running on it} 


TMB MB=MB1 FORCE {Terminates immediately the MEMBER named MB1} 
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8.6.14 TERMINATE_OUTPUT_WRITER (TOW) 


Purpose 


Stops a writer or a remote writer. 


Syntax 
{ TERMINATE OUTPUT_WRITER } 
{ TOW } 
{ * | ALL 
{ ALLDV 
{ PRxx 
ON = { name4 
{ Wnnn 
{ $site:SPOOL 
{ rfile78 
SELCLASS = (a[-a] [al-a]] )] 
STATION = stnnm ] 
STRONG = { bool | 0 } ] 
{ LEAVE } ] 
END = { ] 
{ UNLOAD } ] 
Parameters 
ON The identification of the writer to be stopped, 
expressed as: 
* or ALL all writers (both on devices and files) 
ALLDV all writers operating on devices (but not on files) 
PRxx the writer operating on the named printer 
name4 the writer operating on the named station's logical 
device 
Wnnn the writer where identification (as returned by the 
START_OUTPUT_WRITER command) is Wnnn 
$site SPOOL the standard SYSOUT file of the named site 
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rfile78 


SELCLASS 


STATION 


STRONG 


END 


Rules 
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the writer operating on the named local or remote 
(DPS 7000 or DPS 6) file. (See 
START _OUTPUT_WRITER for syntax and rules.) 


For remote operations, refer to the DPS6 - DPS7 
Remote Facilities manual and to the DJP User's 
Guide. 


restricts the scope of the command to the outputs that 
belong to the specified class(es) or range of classes. 
This may be expressed as: 


class for a single class 
class-class for a range of classes 


where class is a letter (A to Z). When SELCLASS is 
omitted, all started classes are assumed. 


the name of the (unattended) station to which the 
command applies. 


if 1, outputs being printed are stopped immediately; if 
0 (default), the stop is deferred until the outputs being 
printed are ended. 


specifies action to be taken at termination of the tape 
writer: 


UNLOAD requests automatic unloading of the tape. 
LEAVE (default) specifies no automatic unloading. 


This parameter is relevant only if the writer was started 
with PERM=1 (permanent writer) and when all started 
classes are requesting termination. 


e When ON is * or ALLDV, STRONG is ignored 
e IfON is Wnnn, STATION is ignored. 
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Examples 
TOW * ST=RSL6 {Stop all writers on station RSL6.} 
TOW PRL6 STRONG {Stop immediately the writer on the station's logical 


device PRL6.} 


TOW SMST1 :SPOOL ST=PUNCH 


{Stop routing card-punch outputs from station PUNCH 
to host's MST1 standard SYSOUT file.} 


TOW W007 {Stop writer whose identification is W007.} 


TOW <tape-file-description> SELCLASS=A-D END=UNLOAD 
{Terminate a permanent writer on a magnetic tape file 
for the output classes A-D and asks for an automatic 
unloading of the tape.} 
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8.6.15 TERMINATE_POWER_TIMER (TPWRTM) 


Purpose 


This command is used to terminate the timer power control activity. 


Syntax 


{ TERMINATE POWER TIMER } 
{ TPWRIM } 


Parameters 


None. 


Rules 
This command is not available on DPS 7000/2X0/3X0 machines. 


Example 


TPWRTM {Requests termination of the power timer. } 
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8.6.16 TERMINATE_RMS (TRMS) 


Purpose 


Disables the connection of a remote maintenance operator or logs off such an 
operator when already logged on. The connection of an RMS (Remote 
Maintenance System) operator is then submitted to a main operator for approval. 


Syntax 


{ TERMINATE RMS } 
{ TRMS } 


[ ON = { Gcos | SP } ] 


[ LOCK = { PL | LC } ] 


Parameters 
ON Specifies the RMS type: 
GCOS functions on all DPS 7000 machines. 
SP indicates the RMS supported by the Service 
Processors of the DPS 7000/An and the 
DPS 7000/5x0/7xx/8x0/Dx0/Mx0 machines. 
LOCK Designates the PL or the LC object when connecting 


under SP RMS: 


LC means the Logical RMS Connection. It is the 
default for the 
DPS 7000/2X0/3X0/5X0/7xx/8x0/Dx0/Mx0 machines. 


PL means the Physical RMS Line. It is the default for 
the DPS 7000/An. 


On the DPS 7000/5x0/7xx/8x0/Dx0/Mx0, the default 
object when connected through the Service Processor 
(SP), is LC. The LOCK parameter can be used to 
change the object to PL. 
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e Except as explained above for the DPS 7000/5x0/7xx/8x0/Dx0/Mx0, an 
incompatible object causes the command to be rejected. 


e When ON=GCOS, ENABLE must be equal to LC. 


Examples 
TRMS 


TRMS ON=SP LOCK=PL 


TRMS ON=SP LOCK=LC 


{Terminates a GCOS type RMS session. } 


{On the DPS 7000/5x0/7xx/8x0/Dx0/Mx0, forces 
physical disconnection of the line forbidding all 
incoming and outgoing calls. On the DPS 7000/An, 
outgoing calls are still permitted. } 


{On the DPS 7000/5x0/7xx/8x0/Dx0/Mx0, when the 
LC state is WAIT or USED, this command invalidates 
the logical connection. It allows the main operator to 
terminate immediately a USED (interactive or transfer 
out) session. It brings the Logical RMS connection 
back to the LOCK state; the physical line remains 
valid and another call can be submitted to the main 
operator for authorization. } 
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8.6.17 TERMINATE_SERVICE (TSRV) 


Purpose 


This command stops a SERVICE on all the MEMBERS. This command is a part of 
the High Availability product (HA). For more information, see the High 
Availability Administrator's Guide. 


Syntax 


{ TERMINATE SERVICE } 


{ TSRV 


RESYNC = 


{ bool | 0 } 


FORCE = { bool | 0 } 


{ SERVICE } 


{ 

{ SRV 
[ 

[ { 
[ { OPT 


Parameters 
SERVICE 
OPTION 


RESYNC 
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{ OPTION } 


char255 ] 


] 


Name of the SERVICE. 


String of parameters which are specific to this type of 
SERVICE, such as the parameters given at the M 
STOP command of a TDS. 


Used to terminate the SERVICEs which had been 
terminated on the "co- MEMBER" during failure of the 
"current MEMBER" where there has been a DOUBLE 
FAILURE. 


To use RESYNC the following conditions must be 
met: 


— the co-MEMBER must be crashed, silent or telecom 
isolated. 


— the SERVICE to terminate must be HA 
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— the BACKUP SERVER must be running on the 
current MEMBER 


FORCE The FORCE parameter terminates the SERVICE 


immediately. The JAS SERVICES are also considered 
terminated even if there are batch jobs using them. If 
these jobs are being journalized they are aborted; if 
not, the operator uses the DISPLAY JAS command to 
identify them, then the CANCEL _JOB command to 
terminate them manually. 


Rules 
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If the FORCE parameter is not used, a JAS type SERVICE is not terminated 
until all the steps that use it are terminated. Steps that use the journal terminate 
normally; all others, which can be identified with DJAS, must be terminated 
manually with the CANCEL JOB command. 


If it is a JAS type SERVICE to be terminated, a batch job running on this 
SERVICE is allowed to finish unless the FORCE parameter is used. 


The CMSR of the MEMBER on which this command is entered must be 
running. 


This command cannot be submitted between the messages "CMSR 
RESYNCHRONIZATION IN PROGRESS" and "END OF CSMR 
RESYNCHRONIZATION". 


The SERVICE must be in the COMPLEX description. 


If the SERVICE to be terminated is still in use by another SERVICE, it is not 
terminated unless the FORCE parameter is entered in the command. 


If there is an isolation of the ACTIVE MEMBER, the CMSR rejects the 
command. 


If the RESYNC parameter is entered, there must be a DOUBLE FAILURE, and 
the service to be terminated must be HA. 


Two successive TERMINATE SERVICE commands without the FORCE 
parameter are only accepted if the SERVICE type is TDS. This is useful to 
modify the OPTION parameter. 


A TSRV command with FORCE has priority over TSRV without FORCE. 
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Examples 


TSRV SRV=GREEN {Terminates the SERVICE named GREEN on all the 
MEMBERS where it is running. } 


TSRV SRV=TDS1 OPT=DISREST 
{Terminates the SERVICE named TDS1 on all the 


MEMBERS where it is running; in this example it 
corresponds to the TDS command M STOP with the 
parameter DISREST.} 


TSRV SRV=GREEN FORCE 
{Terminates immediately the SERVICE named 


GREEN on all MEMBERs where it is running.} 
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8.6.18 TERMINATE_SSI (TSSI) 


Purpose 


Terminates the SSI on OPEN 7. 


Syntax 


{ TERMINATE SSI } 
{ TSSI } 


[ STRONG = { bool | 0 } ] 


Parameters 


STRONG requests urgent termination. 


Rules 


e The SSI and ACSEL processes are halted. This breaks the connection between 
the local GCOS 7 and the cartridge library server. 


e The STRONG parameter forces an immediate termination of the ssi and acsel 
processes (kill -9). You should avoid this option. 


e Innormal use, the TERMINATE _SSI command is necessary if the SSI 
configuration needs to be modified. 


e You can either terminate CLX before terminating SSI or keep CLX running. 
However, terminating SSI can cause a termination of CLX. 


Example 


S: TSSI 
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8.6.19 TERMINATE_SYSTEM (TSYS) 


Purpose 


Asks for a system shutdown. No further jobs are allowed to start; the main operator 
is logged off when all jobs have reached the end of their current step or a 
checkpoint; the system then shuts down and traffic stops. The main operator is 
logged off if working in CONS operating mode. Otherwise he must enter the 
"BYE" command or modify the operating mode. 


Syntax 
{ TERMINATE SYSTEM } 
{ TSYS 
GCOS 
[iNET ={-béek [0.4.4 
[ PWROFF = { bool | 0 } ] 
[ RESET = { bool | 0 } ] 
Parameters 
GCOS must be specified for an effective shutdown. This 
parameter is present to avoid an accidental shutdown 
as a consequence of wrongly selecting 
TERMINATE SYSTEM ona command menu. 
INIT This parameter is valid only for DPS 7000 Systems. 


if 1, the system is completely reinitialized (hardware 
and firmware) from the device specified through the 
MDRSO command, provided that the REPEAT option 
is active. 

if 0 (default), no automatic reinitialization takes place. 
Depending on the value of the REPEAT option, the 
system is automatically reloaded or not after the 
shutdown is completed. The REPEAT option value can 
be set by using the MDRSO command. To display the 
REPEAT option, use the DRSO command. 
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The following options are not available on the DPS 7000/2X0 or 3X0. 


PWROFF If 1, the system is automatically powered off once 
shutdown is completed. If 0 (default), the system 
remains powered on after termination. 


RESET If this option is available, it specifies that the operator 
must reinitialize the system to reload it. Default=0 (no 
reinitialization needed). 


Rules 


e If some jobs are suspended, the command is denied. All suspended jobs must be 
released before shutdown. 


e If there are Services running under the Complex Management Server (CMSR) 
product, the command is denied. 


e When GCOS=0, the command is ignored. 
e INIT, PWROFF, and RESET are mutually exclusive. 


Examples 
TSYS GCOS {Asks for system shutdown. } 


TSYS GCOS PWROFF {Asks for system shutdown, followed by system 
power-off. } 
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8.6.20 TERMINATE_SYSTEM_TRACE (TSYSTR) 


Purpose 


TSYSTR stops the system trace collector service job, stops domain trace activity 
undefined classes, and stops the domain WAIT mode for trace event requests. 


NoTE: 
This command is to be used only under the direction of a Bull support engineer. 


Syntax 
{ TERMINATE SYSTEM TRACE } 
{ TSYSTR } 
[ { DOMAIN } { ALL vl 


[ {DM }={* a 
[ { ToomM } { star64 } ] 


[ CLASS = {NOR|DET|TRM|INR| IDT|CND|DTV|ABN|ARC|TRP|TDP|ALL}] 


[ WAIT = bool ] 


[ { COLLECTOR } ] 
[ } = bool ] 
[ { CLTR } ] 
Parameters 
DOMAIN It is the name of a system trace domain or, if ALL (the 


default) or * is specified, all domains. Maximum 
length is 64 characters. 


CLASS It is either ALL (the default, meaning all classes) or a 
system trace class name. Correct values are: NOR, 
DET, TRM, INR, IDT, CND, DTV, ABN, ARC, TRP, 


and TDP. 

WAIT If 1, the domain WAIT mode is to be stopped; if 0, the 
WAIT mode is not stopped. 

COLLECTOR If 1, the system trace collector service job is to be 


stopped; if 0, the trace collector is not stopped. 
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Rules 


e The domain WAIT attribute is meaningless, unless a system trace collector is 
active. 


e CLASS and WAIT are mutually exclusive. 
e If COLLECTOR is specified no other parameter may be specified. 


Examples 


TSYSTR DOMAIN=MYTDOM 
{Close all MYTDOM domain classes. } 


TSYSTR DOMAIN=MYTDOM WAIT 


{Reset trace event WAIT mode for requests issued for 
MYTDOM domain. } 


TSYSTR COLLECTOR 
{Stop the system trace collector service job.} 
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8.6.21. TERMINATE_TERMINAL_OUTPUT (TTO) 


Purpose 


Terminates the printing of outputs on a terminal or pool of terminals or modifies 
the class of outputs that can be printed on them. Only the owner of the object 
terminal or users declared as Master Operators for the Generalized Terminal Writer 
may use this command. Refer to the GTWriter User's Guide for a complete 


description. 
Syntax 
{ TERMINATE TERMINAL OUTPUT } 
{ TTO } 
{ TERM } 
} = namel12 
{IN J 


[SELCLASS = a[-a]] 


[STRONG = { bool | 0 }] 


Parameters 

TERM the name of the terminal or pool of terminals to be 
terminated or modified. 

SELCLASS indicates the class (SELCLASS = a) or range of 
classes (SELCLASS = a-a) which are no longer 
eligible for printing on that terminal or pool of 
terminals. If no class is left for the terminal or pool, it 
is stopped. 

STRONG if 1, terminate even if an output is being printed. 
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Rules 
SELCLASS and STRONG are mutually exclusive. 


Examples 

TTO POOL3 {Stop printing on terminal pool POOL3.} 

TTO POOL3 STRONG {Stop printing on terminal pool POOL3, even if 
printing. } 

TTO POOL3 A-D {Stop printing for classes A through D on pool 
POOL3.} 
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8.6.22 
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Purpose 


TERMINATE_TERMINAL_WRITER (TTW) 


Shuts down one or all of the Generalized Terminal Writer drivers. Refer to the 
GTWriter User's Guide for a complete description. 


Syntax 


{ TERMINATE TERMINAL WRITER } 


{ TIW 


[STRONG = { bool | 0 }]; 


Parameters 


name4 


ALL 
FORCE 


STRONG 


Rules 


None. 
Examples 
TIW 


TIW TWO1 


TIW FORCE 


TIW TWO1 STRONG 


This is the name of the driver to be stopped (4 char.). 
When omitted, all drivers (ALL) are assumed. 


The default parameter shuts down all the drivers. 


This parameter shuts down the command handler as 
well as all the drivers. The TSYS command has the 
same effect. 


This parameter is used with one of the other 
parameters. It immediately stops the output. For 
example, any output that is printing is frozen. 


{shutdown all drivers} 
{shutdown driver TWO1} 
{shutdown all drivers and the command handler} 


{shutdown driver TWO1 immediately} 
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TEST_DEVICE (TSTDV) 


Purpose 


Description of the Operator Commands (Part 2) 


Starts and stops a print test for those printer devices that have no PRINT TEST 


pushbutton. 


Syntax 


{ TEST DEVICE } 
{ TSTDV } 


{ DEVICE } 


{ 
{ DV 


ACTION = 


Parameters 


DEVICE 


ACTION 


Rules 


None. 


Examples 


TSTDV PRO3 START 


TSTDV PRO3 TERM 


the identification of the printer device for which the 
test is to be started or stopped. 


If START, the test is started on the named printer 
device when it is set to the READY state from 
STANDBY. After the test, the printer is automatically 
reset to STANDBY. The test is restarted when the 
printer is again set to the READY state. If TERM, the 
test is terminated (i.e., setting the printer to READY no 
longer initiates the test). 


{start a print test for printer PRO3} 


{terminates the print test for printer PRO3} 
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8.7 "U" Commands 


8.7.1 UNLOCK_MIRLOG_FILE (UNLMIRF) 


Purpose 


Unlocks either logical subset (RECAREA, NSTDTAB) of the SITE.MIRLOG file 
when it has been locked by the other system in coupled systems environment. 


This command is available only if the system has been configured with MIRROR = 
YES. 


ATTENTION: 
This is a dangerous command, to be used only after one of these messages: 


MR17 WARNING: RECAREA OF THE SITE.MIRLOG IS LOCKED BY 
THE OTHER SYSTEM 


MR17 WARNING: NSTDTAB OF THE SITE.MIRLOG IS LOCKED BY 
THE OTHER SYSTEM 


An OCL version exists, intended to be used at GCOS 7 restart (before GCOS 


READY). 
Syntax 
{ UNLOCK _MIRLOG FILE } 
{ UNLMIRF 
{ RECAREA } 
PART = { 
{ NSTDTAB } 
OCL syntax 


UMIRF { RECAREA } 
{ NSTDTAB } 
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Parameters 

PART This parameter identifies the logical subset of the 
SITE.MIRLOG file that is to be unlocked: 
RECAREA is unlocked to enable resynchronization 
and restart. 
NSTDTAB is unlocked to enable copy invalidation. 

Rules 


Refer to the Mirror Disks User's Guide. 


Example 


UNLMIRF PART=RECAREA 
{Unlocks logical subset RECAREA of the 
SITE.MIRLOG file and displays the message: "MR18 
UNLOCK OF THE RECAREA PART OF THE SITE. 
MIRLOG SUCCESSFUL"} 
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8.7.2 UNLOCK_MIRROR_VOLUME (UNLMIR) 
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Purpose 


Unlocks the MIRLAB of the either disk belonging to a pair of SHARED mirrored 
disks, when locked by the other system in coupled systems environment. 


ATTENTION: 
This is a dangerous command, to be used only after the message: 


MR18 WARNING: MIRLAB OF volname:dvc IS LOCKED BY THE 
OTHER SYSTEM 


It unpairs two mirrored disks of a dual volume. 


An OCL version exists, intended to be used at GCOS restart (before GCOS 
READY). 

This command is available only if the system has been configured with MIRROR = 
YES. 


Syntax 
{ UNLOCK _MIRROR_VOLUME } 
{ UNLMIR } 
{ VOLUME } 
} = volname-6:device class 
{ VOL } 
OCL syntax 


UMIRV volname6é dvc 


Parameters 


VOLUME Identification (volume name:device class) of the pair 
of mirrored disks. Ex : MIRB55:MS/B10. 
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Rules 


Refer to the Mirror Disks User's Guide. 


Example 


UNLMIR MIRB55:MS/B10 
{displays the message: 
MR18 UNLOCK OF MIRLAB OF MIRB55 
MS/B10 SUCCESSFUL} 
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8.7.3 UNPAIR_MIRROR_VOLUME (UNPMIR) 


Purpose 


Unpairs the two disks of a mirrored pair; the disk specified via the KEEP parameter 
becomes MIRROR ALONE, while the other disk goes NSTD MIRROR (when it is 
accessible). 


This command is available only if the system has been configured with MIRROR = 


YES. 
Syntax 
{ UNPAIR_MIRROR_VOLUME } 
{ UNPMIR } 
{ VOLUME } 
{ } = volname-6:device class 
{ VOL } 
{ PRIMARY  } 
KEEP = { } 


{ SECONDARY } 


Parameters 

VOLUME Identification (volume name:device class) of the pair 
of mirrored disks. Ex : MIRB55:MS/B10. 

KEEP Identification of the copy to be kept as valid copy of 
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the volume 1.e. the disk which is to become ALONE. 
Possible values: PRIMARY or SECONDARY 
keywords. 
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Rules 
Refer to the Mirror Disks User's Guide. 


Example 


UNPMIR MIRB55:MS/B10 KEEP=PRIMARY 
{displays the messages: 
MRO3 INVALIDATION OF MIRB55 MS/B10 
REQUESTED BY OPERATOR 
MR12 UNPMIR ACCEPTED 
DV26 dvnml PREMOUNTED MIRB55 NSTD 
MIRROR 
MRO8 dvnm2 MIRB55 MIRROR ALONE } 
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9. Remote Multiplexed Operator Support 
(RMOS) 


9.1 Introduction 


This section introduces the DOF7-RM product, also known as RMOS (Remote 
Multiplexed Operator Support). 


e how to use RMOS commands. 
e how to leave RMOS. 

e RMOS screens. 

e RMOS error messages. 


HELP TEXTS 


On-line documentation in the form of Help texts is available to you at all levels of 
operation. These help texts contain a subset of the information in this section. To 
obtain help texts, enter the question mark (?) in the control field as a reply to the 
appropriate prompt. The first screen displayed gives a description of RMOS 
commands. 


Table 9-1. Summary Description of RMOS Commands 
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9.1.1 Definition of RMOS 


The Remote Multiplexed Operator Support is an interactive processor that runs 
under IOF. Its purpose is to monitor one or several sites using the same operator 
terminal without having to log-on/log-off. RMOS allows you to multiplex several 
interactive sessions between your local site and one or more applications located on 
the same or other sites. The connection between the RMOS processor and the 
monitored site(s) is called a link. 


You normally proceed as follows: 


1. 


Seo 


You establish a link with a site using the LINK command. A link is 
completely identified by site, user, and application. You can have up to 64 
existing links simultaneously. You can establish zero, one, or more links to a 
single site. The site concerned can be local or remote. If you make more than 
one link to the same site, then the user and/or the application must be 
different. A link can be considered as an interactive session with an 
application. A link remains defined until either you delete it explicitly 
(UNLINK command), leave the linked application using its exit procedure 
(e.g., BYE for IOF), or leave RMOS (QUIT command). 


You select a link to become the current link using the SELECT command. 
Messages issued by the selected link (in fact by the application for the user at 
the selected site) are displayed on your terminal. This link remains as the 
selected link until you select another link. 


You can display the status of the link(s) using the DISPLAY command. The 
CONTROL command specifies the operating mode of this display. 


You can use the INTERRUPT command to cause a break at a selected site. 
You can suppress unwanted pending messages using the PURGE command. 
You can delete a link that is no longer needed using the UNLINK command. 
You leave RMOS using the QUIT command. This implicitly deletes all links. 


You must remember two important points: 


Because RMOS is an interactive processor, a user running under a project with 
the MAIN attribute cannot activate it. 


RMOS only multiplexes connections (links) and does not perform message 
management. To select messages, use the relevant filter commands at each 
connection level. 
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9.1.2 Functions 


With RMOS you can: 


1. Create/delete up to 64 links between one RMOS processor and the 
local/remote site(s). The actual number of links are limited by such resources 
as memory, the multiprogramming level made available and the space 
occupied by temporary files. 


2. Store for each existing link all incoming messages from the remote sites in a 
Queued Linked subfile. This file is associated with the link when it is set up. 
This means you can retrieve these messages on the RMOS Operator Terminal 
when needed. 


3. Select at any time one of the existing links to dialog with the remote site as if 
the RMOS Operator were directly logged on at the site. 


4. Display existing links and their status. 
5. Display for all links messages requesting the RMOS Operator's attention. 


6. Attempt to make an automatic reconnection after an abnormal link 
disconnection. 


7. Support up to nine simultaneous RMOS processors executing concurrently on 
the same system. 


NoTE: 
The local site where RMOS is loaded must have GCOS 7 V3 or later releases. 
The "remote sites", with which the links are established can be in any GCOS 7 
release but a link with the MAIN attributes is supported as from GCOS 7 V3. 
Links with the older Level 64 sites are not supported. 


9.1.3 Basic Architecture 
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RMOS is an interactive processor called under IOF. 


RMOS consist of two processes. The first process (PO) is in charge of the RMOS 
Operator terminal management involving command processing, dialog with remote 
sites when a link is active, status display. The second process (P1) is in charge of 
managing remote sites. 


RMOS commands are GCL commands belonging to a specific domain named 
"RMOS" which is automatically initialized at RMOS processor start time. 


The RMOS processor is connected to the remote sites using VCAM (Virtual 
Communications Access Method). These RMOS connections or links are said to be 
Pass-Through type links. 
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After you enter the ENTER RMOS command, you can specify which storage 
techniques you wish to employ for storing incoming messages by specifying the 
MODE parameter. If you specify MODE = FILE, you can either name an existing 
Queued File with the correct allocation parameters or let RMOS create a temporary 
file to be used during the RMOS session and deleted when it is over. The only 
advantage of a permanent file is that you may locate it more easily. If you specify a 
permanent file and RMOS is unable to open it, RMOS displays an error message 
on your terminal and allocates a temporary file. For each link, one subfile is 


created. 


A change of operating mode implies terminating the current session and restarting a 


new one. 


When the file is full, RMOS automatically allocates additional space up to the 
maximum file size limits. When these maximum values are reached, the RM53 
message (UNABLE TO EXTEND RMOS FILE: SOME MESSAGES MAY BE 
LOST) is issued. At this point, RMOS deletes the oldest messages in the largest 
subfiles for links which have not been recently selected. 


In the case of overflow, RMOS reduces the size of the largest subfiles and thus 
equally distributes messages over all the subfiles. Use the SELECT or PURGE 
command to create more space; then you can resume normal FILE Mode 


processing. 


Characteristics of the file used to store incoming link messages: 


VBO 


FILEFORM = 
FILEORG = 
BLKSIZE 
RECSIZE 
RECFORM 
DELREC 

COMPACT 


BFAS 
LINKQD 
6200 
6196 


= VB 
= YES 
= NO 


FBO 


FILEFORM = 
FILEORG = 
BLKSIZE 
RECSIZE 
RECFORM 
DELREC 

COMPACT 


LINKQD 
LINKQD 
6200 
6196 
VB 


= YES 
= NO 


Any other parameters depend on size, location and number of links to be handled. 
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9.1.4 RMOS Operator Levels 


RMOS contains three levels: 


e Command level. 
e Display level. 


e Select level. 


9.1.4.1. Command Level 


On executing the ENTER RMOS command (of the IOF domain), you enter RMOS 
at the command level. In serial mode, the prompt 0: is displayed at this level. The 
following commands leave you at command level after execution. 


CONTROL 
LINK 
PURGE 


UNLINK 


9.1.4.2 Display Level 


The command DISPLAY places you at the display level after execution. To return 
to command level, you issue a break (if in AUTOMATIC display MODE) or enter 
a Slash (/) command (if in MANUAL display mode). AUTO and MANUAL are 
possible values for the MODE parameter of the CONTROL command. 
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9.1.4.3. Select Level 


The RMOS commands INTERRUPT and SELECT place you at the select level 
after execution. To return to command level, you issue a break. 


The following table summarizes the above discussion. 


Table 9-2. Summary of RMOS Tasks 


TASK USE LEVEL RETURN TO 
COMMAND RMOS 

COMMAND 
LEVEL 


Specify/modify the display mode CONTROL COMMAND|  —_—s 


Display information about a site DISPLAY DISPLAY soa 
(AUT/MAN) or "/" 
(MANUAL) 


Hhinkastetw MOS PLINK [COMMAND 
Delete unwanted pending messages [PURGE [COMMAND [SSS 
TleaveRMOSSSC*QUIT. CSCO SSCS~S 
Delete alink  [ UNLINK_[COMMAND[ SS 
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9.2 Description of RMOS Commands 
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This section describes each RMOS command in detail, and shows you how to use 
each command. The commands are presented as follows in alphabetical order, to 
facilitate ease of reference: 


CONTROL 
DISPLAY 
INTERRUPT 
LINK 
PURGE 
SELECT 
UNLINK 


The description of each command begins on a new page. For each command, 
details include: 


purpose, 
command syntax, 
description of parameters, 


e 
e 
e 
e an example of the use of the command. 


PMOS GCOS 7 commands have two standard forms which work just the same: 
1. The full command (verb): CONTROL. 


2. The abbreviation: CTL. 


Certain commands and parameters, usually those that are rarely used, are not 
included in the menu and or prompt mechanism. The parameters in this category 
are listed in this section below a dashed line:---------------------------------------- : 


You have these parameters listed in the menu by entering a plus (+) after its name, 
rather than a question mark (?). There are no help texts for these parameters. 
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9.2.1 
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RMOS (ENTER RMOS) 


Purpose 


RMOS multiplexes several interactive sessions between your local site (the site at 
which you execute the ENTER_RMOS command), and one or more applications. 


On executing the ENTER_RMOS command, you leave the IOF domain and enter 
the RMOS domain. When the processor is ready to accept commands, a specific 
RMOS prompt is displayed (0:). 


Syntax 

{ ENTER _RMOS } 

{ RMOS } 
[ { FILE }] 
[ MODE = { }] 
[ { MESSAGE } ] 


[FILE = libnm ] 


Parameters 

MODE Specifies the mode in which RMOS is to operate. 

MESSAGE Messages issued by a LINKed site (which is not yet 
SELECTed) are not placed in a file. They are put in the 
queue at the issuing site. In this case, you must omit 
the FILE parameter. 

FILE Messages issued by a LINKed site are placed in a file 


until the site is SELECTed (LINK and SELECT are 
commands of the RMOS domain). 

The file is either a temporary one created by RMOS 
(default), or an existing file specified via the FILE 
parameter. 

If you omit MODE, the default is MODE = FILE. 


Note that in file mode, the number of buffers created 
for accessing file(s) increases with the number of 
linked sites. Because the size of each buffer is 6 
Kbytes, a large amount of memory is used. 
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You enter the name of an existing SL library. The file 
must be present at your local site (i.e. the site where 
you issued the ENTER RMOS command), and its 
block size must be greater than or equal to 6200 bytes. 


Messages issued by a LINKed site are placed in this 
file until the site is SELECTed (LINK and SELECT 
commands of the RMOS domain). 


If you omit FILE (and MODE is not MESSAGE) then 
by default, RMOS creates a temporary file which will 
be deleted at the end of the RMOS session. 


Examples 
ENTER _RMOS; (Activate the RMOS processor. By default, messages are 
placed in a temporary file created by RMOS.) 
ENTER _RMOS FILE = (Activate the RMOS processor. By default, messages are 
P1.MYSL1; placed in the catalogued SL library P1.MYSL1. This library 


exists at your local site.) 


ENTER _RMOS MODE (Activate the RMOS processor to operate in RMOS mode. 
MESSAGE ; Messages are not be placed in a file; they are put in the 
queue at the issuing site.) 
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9.2.2 CTL(CONTROL) 


Purpose 


Specifies/modifies the attributes of the RMOS display (produced by the DISPLAY 
command). The abbreviation for the CONTROL command is CTL. 


Syntax 
{ CONTROL } 
{ CTL } 
[ { AUTO 


[{ DISPLAY DELAY } 


C{ 


[{ DELAY 


Parameters 


MODE 


AUTOMATIC (AUTO) 


MANUAL 


9-10 


} = [dec2] 


} 


[.dec2] 


— 


This parameter specifies the mode used to handle a 
multi-page display. 


The display automatically switches to the next page 
after a specified time period which is determined by 
the value of the DISPLAY DELAY parameter. Once 
the last page is reached, the display automatically 
restarts from the first page. To leave the display, you 
issue a break. AUTO is the default. 


You control the display by entering command(s) in the 
control field, indicated by the arrow in the upper 
right-hand corner of the screen. 

>[n] Advance page or n pages if n is specified. 

<[n] Go back page or n pages if n is specified. 

=n Display page number n 

R Refresh data and display page | 

/ Leave Display and return to RMOS command level. 
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DISPLAY DELAY (Abbreviation is DELAY) 


CONTROL MODE 


CONTROL MODE 


CONTROL DELAY 


Specifies the time interval between the automatic 
display of successive pages of a multi-page display. 
Such displays can be produced using the DISPLAY 
command. You enter a value on the form [min] [.sec], 
where min = minutes, and sec = seconds. 
Leading/trailing zeros may be omitted. Seconds must 
be introduced by '.'. The specified time must be at least 
5 seconds. The default value is 60 seconds. 


The displays are described in further detail in Section 
9.4 Description of Screens. 


(The display is in manual mode; that is, controlled by 
yourself. In this case the DISPLAY DELAY parameter 
is meaningless.) 


(The display is in automatic mode. Because the 
DISPLAY DELAY parameter is omitted, the default 
value (60 seconds) is assumed.) 


(The time interval between display of two consecutive 
pages is 30 seconds.) 


(The display is in automatic mode and the time interval 
is reset to 60 seconds.) 
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9.2.3. D (DISPLAY) 


Purpose 


This command displays information on your terminal about a site or all sites. The 
abbreviation is D. 


Syntax 

{ DISPLAY } 

{ D } 
[ { { GS mae 
[ { { GLOBAL STATUS wl 
[OPTION = { }] 
[ { { GR Peped 
[ { { GLOBAL REQUESTS } } ] 


Parameters 


OPTION Specifies the type of information to be displayed. 
You can display one of the following: 


GLOBAL STATUS or GS This means a global display of the status of each 
LINKed site. 


Displays the number of messages in the queue coming 
from each site. 

If the flow of messages has been interrupted (for a 
link),the number of messages is highlighted. 

This is the default value if you omit OPTION. 


GLOBAL _ REQUESTS or GR 
This means a global display of all requests coming 
from the linked site(s). The request include all system 
messages beginning with '*' and all messages requiring 
a reply. The later are prefixed with the reply number. 


NOTE: 
To use this option properly, you must activate appropriate filters at the site(s) 
currently linked to RMOS. 
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Examples 


DISPLAY; or D; {Display information about the status of all sites 
currently linked to RMOS. This is the default value if 
you omit OPTION. } 


DISPLAY OPTION = GLOBAL REQUESTS; or D GR; 
{Display information about the requests from all sites 
currently linked to RMOS. } 
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9.2.4 IT (INTERRUPT) 


Purpose 
Used to issue a break to the currently selected site. 


The INTERRUPT command (abbreviation is IT) is ignored if you have not selected 
a site (using the SELECT command). 


If you issue a break (by pressing the appropriate key on your terminal, or by 
entering $*$BRK), this break is handled locally by RMOS; it is never transmitted 
to the selected site. Consequently the INTERRUPT command provides the only 
means of issuing a break that is effective at a remote site. 


INTERRUPT does not stop the display of messages coming from a selected site 
which have already been queued in the RMOS file. To do this, use the PURGE 
command. 


Syntax 


{ INTERRUPT } 
{ IT } 


Parameters 


None. 
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9.2.5 LK (LINK) 


Purpose 


Used to link a site to RMOS. 


Syntax 


{ LINK } 
{ LK } 


SITE = sitenm 

[ TYPE = PT ] 

[ USER = usernm ] 

[ { PASSWORD } ] 

[ { } = charl2 ] 

[ { Psw } ] 

[ PROJECT = projnm12 ] 

[ BILLING = names ] 

[ { APPLICATION } ] 
[ { } = name12 ] 


[ { APPL } ] 


[ STATION = stnm ] 


[ OPTIONS = name22] 
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Parameters 


SITE 


TYPE 


USER 
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Name of the site to which a link is to be made by the 
LINK command (See OPTIONS parameter). The site 
can be local (that is the site at which you activated 
RMOS), or remote (1.e. a site other than the site at 
which you activated RMOS). 


Your enter the name of a site known on your network; 
the name must be that used in the RSYS parameter of 
the CNC (Communications Network Configuration). 
The name can be up to four characters long. It can be 
made up of the letters (A- Z) and the digits (0-9). It 
must begin with a letter. 


Note that the link being made is identified by SITE, 
USER (specified explicitly or taken by default), and 
APPLICATION (specified explicitly or taken by 
default). The user and the application must exist at 
SITE, and the user must be known to the application at 
SITE. 


Specifies the type of link to be made. 

The only type available in the current version of 
RMOS is TYPE=PT (Pass-Through). This is the 
default value. 


Specifies the name of the user to be associated with the 
link being established by the LINK command. 


The user name entered must be known at the site to 
which the link is being made. The user must also be 
known to the application concerned at this site. If you 
wish to use the link to perform remote site operation, 
then the user must also have the MAIN attribute at the 
site being linked. 


If you omit USER, the user name under which you 
activated RMOS is taken as the default. This name 
must comply with the details in the previous 
paragraph. 


47 A2 53US 


47 A2 53US 


PROJECT 


BILLING 


PASSWORD 


STATION 
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Specifies the name of the project to be associated with 
the link. The name you supply must be a valid project 
on the site to be linked. The user name must be 
registered under that project. 


If you omit PROJECT, the default project for the user 
name (as registered in the site catalog of the site being 
linked) is assumed. 


Specifies the name of the billing to apply to the session 
with the site being linked. 


You cannot specify BILLING unless you also specify 
PROJECT. 


The name you supply must be a valid billing for the 
project specified via PROJECT on the site to which the 
link is being made. 


If you omit BILLING, the default billing for the project 
is assumed. 


The password parameter (abbreviation PSW) specifies 
the password for the user specified via the USER 
parameter. 


If you specify USER and there is a password 
associated with the user, you must also give the 
password. 


If you omit USER (and PASSWORD), then your own 

user name and password are used. These must be valid 
at the site to be linked (that is, they must be registered 

in the site catalog of that site). Your password must be 

the same at both sites. 


Specifies the name of the station to be associated with 
the link. 


The name you supply must be a valid station name on 
the site to be linked. The station must be known to the 
application concerned. 


The name can be up to eight characters long. It can be 
made up of letters (A-Z) and digits (0-9). It must begin 
with a letter. 


If you omit STATION, the default station for the 
project is assumed (even if you have not explicitly 
specified the project name). 
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APPLICATION 


OPTIONS 
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Specifies the name of the application to be accessed. 
The abbreviation is APPL. 


You enter the name of the application which exists at 
the site being linked. The application must be one of 
those permitted to the user (USER parameter) as 
defined in the site catalog of the site being linked. 


If you omit APPL, the default is IOF. 


Used to transmit option parameters to the application 
to which the link is being made. 


IOF applications option values: 


— NS: No optional start-up execution at link 
connection time. 


— NEW: Starts a new IOF session (even if a 
disconnected session is available for reconnection). 


— NM: Cancel mail display. 


— INT: Start the IOF session in interactive mode 
(when creating a link with a user who would 
otherwise implicitly be in CONS mode). 


— *envt: Asterisk followed by the name of the 
environment under which the application is to start. 


The values given are interpreted by the application 
concerned. 


If you omit OPTIONS, there is no default. In this case, 
no link option is transmitted to the application. 


Links to TDS applications: 
— Application = tdsnm 


— Options = Refer to the DNS Terminal Management 
Reference Manual. 
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Examples 


LINK SITE = MINE TYPE = PT USER = ME PROJECT = MYPROJ1 

BILLING = MYBILL1 PASSWORD = XYZ STATION = ST3 OPTIONS = 'NS NEW'; 
(A link is to be made to the site named MINE. The 
type of link to be made is PT (Pass Through); the user 
is ME; the project name is MYPROJ1; the billing is 
MYBILL1; the password is XYZ; the station name is 
ST3; the application is IOF by default; the options are 
no optional start-up execution and start a new session.) 


LINK SITE = OURS OPTIONS = 'NM *E3'; 
(A link is to be made to the site named OURS. The 
display of mail is suppressed and the environment 
named E3 is used. 


The following default values are assumed: the type is 
PT; the user is the user name under which you 
activated RMOS; the project is the default project for 
the user name (as registered in the site catalog of the 
site being linked); billing is the default billing for the 
project; your own password, which is registered in the 
site catalog of OURS; the station is the default station 
for the project; the application is IOF.) 
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9.2.6 PRG (PURGE) 


Purpose 


Used to delete unwanted pending messages from a linked site which is not 
currently selected. This command is particularly useful when a link is not going to 
be SELECTed and a large number of messages are accumulating in the file (with a 
risk of overflow). The command abbreviation is PRG. 


Since PURGE deletes messages from a file, PURGE is meaningless if a file is not 
being used (that is, if you specified MODE = MESSAGE when calling RMOS). 


Since PURGE is available only at RMOS command level, it cannot be used to 
delete messages being issued by the currently selected site. To do this, you must 
use the INTERRUPT command. 


Syntax 
{ PURGE } 
{ PRG } 


SITE = sitenm 


[USER = 


[{ APPLICATION } 


C{ 
[{ APL 


Parameters 


SITE 
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] 
= names ] 


] 


Specifies the name of the site for which pending 
messages are to be purged. 


You enter the name of a linked site, that is, you must 
have previously executed a LINK command for this 
site during the current RMOS session. 


If necessary, the link can be more fully identified using 
the USER and APPLICATION parameters. 


You must enter a value for SITE as there is no default. 
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USER 


APPLICATION 


Examples 


PURGE SITE 


PURGE SITE = 
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Specifies the user name associated with the LINK 
whose messages are to be deleted. You enter the user 
name given when the link was made using the LINK 
command. 


If you omit USER, the user name associated with the 
only existing link to the site (as given via the SITE 
parameter) is assumed. 


If there is more than one existing link to SITE, then 
there is no default value for USER. In this case, if you 
omit USER, the PURGE command is not executed. 


Specifies the application associated with the link. 


(Purge pending messages associated with the link 
identified by the site named MINE. Because USER 
and APPLICATION have been omitted, there is only 
one link with this site.) 


REM 3 USER = OPER APPL = IOF; 


(Purge pending messages associated with the link 
identified by the site named REM3, the user named 
OPER, and the application IOF.) 
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9.2.7. Q(QUIT) 


Purpose 
Used to leave the RMOS processor. 


Once the QUIT command (abbreviation is Q) is executed, all linked sites are 
automatically unlinked and the session with the current selected site is terminated. 
All messages stored in the RMOS file, if any, are deleted. 


In order to prevent an error, the following question is displayed: 
RM57 DO YOU WANT REALLY TO QUIT RMOS? 
to obtain confirmation of the operator's intention to quit. 


QUIT causes you to leave the RMOS domain and return to the IOF domain. 


Syntax 

{ QUIT } 
{ } 
tae 30 


Parameters 


None. 


NOTE: 
You can also execute a QUIT command by entering a slash (‘/") character as the 
command in non-menu mode. 


Example 


QUIT; (Leave RMOS.) 
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Purpose 


Used to select a link. 
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The command abbreviation is SEL. 


Syntax 
{ SELECT } 
{ SEL } 


SITE = sitenm 


[ USER = usernm ] 


[ 
a 
[ { APPL 


Parameters 


SITE 


USER 


APPLICATION 


{ APPLICATION } ] 


} = names ] 


Specifies the name of the site for which a link is to be 
selected. 

You enter the name of a linked site, that is, you must 
have previously executed a LINK command for this 
site during the current RMOS session. 

If necessary, the link can be more fully identified using 
the USER and APPLICATION parameters. 

You must enter a value for SITE as there is no default. 


Specifies the user name associated with the link to be 
selected. You enter the user name given when the link 
was made using the LINK command. 

If you omit USER, the user name associated with the 
only existing link to the site (as given via the SITE 
parameter) is assumed. 

If there is more than one existing link to the SITE, then 
there is no default value for USER. In this case, if you 
omit USER, the SELECT command is not executed. 


Specifies the name of the application (abbreviation is 
APPL) associated with the link to be selected. You 
enter the application name given when the link was 
established (using the LINK command). 
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If you omit APPLICATION, the application with the 
only existing link to the site (given in SITE parameter) 
is assumed. 

If there is more than one existing link to SITE, then 
there is no default value for APPLICATION. IOF is 
the default application. 


Examples 


SELECT SITE=MINE; (Select the link to the site named MINE. As USER and 


APPLICATION have been omitted, there must be only 
one link to this site, and this is selected.) 


SELECT SITE = OURS USER = ME APPLICATION = TDSY; 


(Select the link to the site named OURS, identified by 
the used named ME and the application name TDSY.) 


NOTES: 


1. 


If RMOS is operating in FILE mode, once the link has been selected, all 
messages issued since the previous selection (or time of link-up if this is 
the first time you have selected this link) are displayed at your terminal. 
After the messages are displayed, normal dialog is resumed. 


This dialog depends on whether the application is in INT (interactive 
mode) or in CONS (console mode). INT and CONS are parameters of the 
MODIFY OPERATING MODE command. 


If you are in INT mode, then after the messages have been displayed, you 
are given control. The prompt site-name: appears on your terminal. If you 
are in CONS mode, then after the messages have been displayed, the 
selected site retains control. To obtain control, do the following: 


a) Issue a break at your terminal. This break is handled by RMOS which 
returns you to RMOS command level. 
b) Enter an INTERRUPT command to send a break to the selected site. 


c) The sitenm: prompt appears and you are given control. 


If RMOS is operating in MESSAGE, mode, communication is directly 
established between the RMOS terminal and the application on the target 
site. Any waiting messages in the application mailbox are sent to the 
RMOS by the target application and displayed on the RMOS Operator 
terminal. 


To terminate the selection of a selected site, you issue a break (which RMOS 
handles and returns you to RMOS command level), and enter any RMOS 
command except INTERRUPT. 
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9.2.9 UNLK (UNLINK) 


Purpose 


Specifies the name of the user associated with the link to be deleted. 


Syntax 
{ UNLINK } 
{ UNLK } 


SITE = sitenm 
[ TYPE = PT ] 


[ USER = usernm ] 


[ { APPLICATION } ] 
[ { } = name8 ] 
[ { APPL } ] 
Parameters 
SITE Specifies the name of the site whose link is to be 
deleted. 


You enter the name of a linked site, that is, you must 
have previously executed a LINK command for this 
site during the current RMOS session. If necessary, the 
link can be more fully identified using the USER and 
APPLICATION parameters. You must enter a value for 
SITE; there is no default. 


TYPE OF LINK Specifies the type of link to be deleted. The only type 
available in the current version of RMOS is TYPE = 
PT (Pass Through). This is the default value. 


Other values will be added in future versions. 
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USER Specifies the name of user associated with the link to 
be deleted. You enter the user name given when the 
link was made using the LINK command. If you omit 
USER, the user name associated with the only existing 
link to the site (as given via the SITE parameter) is 
assumed. If there is more than one existing link to 
SITE, then there is no default value for USER. In this 
case, if you omit USER, the UNLINK command is not 
executed. 


APPLICATION The application (abbreviation APPL) parameter 
specifies the name of the application associated with 
the link to be deleted by the UNLINK command. You 
enter the application name given when the link was 
established (using the LINK command). If you omit 
APPLICATION, the application associated with the 
only existing link to the site (as given via the SITE 
parameter) is assumed. If there is more than one 
existing link to SITE, then there is no default value for 
APPLICATION. IOF is the default application. 


Examples 


UNLINK SITE (Delete the link with the site named MINE Type PT 

MINE; link is assumed. As USER and APPLICATION have 
been omitted, there must be only one existing link 
with MINE.) 


UNLINK SITE = OURS (Delete the link with the site name OURS and 


USER = ME identified by the user named ME and the application 
APPLICATION = named TDSZ.) 
TDSZ; 
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9.3 Leaving RMOS 


To leave RMOS, enter the QUIT (Q) or the slash (‘/') character. All active links at 
termination time are closed, and their associated subfile if any, is then closed and 
the contents erased if it is a temporary file. See below: 


SELECT 
INTERRUPT LINK BREAK > 


DIALOG "BYE" 


LINK 
UNLINK 
CONTROL 


DISPLAY 


DISPLAY 


(STATUS 
REQUESTS) 


BREAK (AUTO/MANUAL) 
or 
"/" (MANUAL) 


__\ Y 


Figure 9-1. Screen Format Transitions 
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9.4 Description of Screens 


9.4.1 Global Status Screen Layout 


This screen is displayed after you enter the command. 
DISPLAY OPTION = GLOBAL STATUS. 


The screen shows you the status of all known links for the current RMOS session 
and consists of one or several pages. 


DISPLAY GLOBAL STATUS 


“= 3 
LINKTYPE USER APPL. STATUS #MESSAGES 


= 


usernm applic. s nnnnnn 


usernm applic. 


TOTAL NUMBER OF LINKED SITES 


FILE SPACE AVAILABILITY : YY 


Figure 9-2. Display Global Status 
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Field Descriptions 


AUTO 


SITE 

LINK TYPE 
USER 
APPL. 
STATUS 


#MESSAGES 


Remote Multiplexed Operator Support (RMOS) 


Number of the current page. 
Total number of pages of the display (max. is 99). 


The display is automatically managed according to the 
time interval specified through the CONTROL 
command (default is 60 seconds). 

You control the screen manually by entering 
commands in a two-character control field. See Section 
9.2.2 CTL (CONTROL). 


Name of the site to which the link is made. 

Type of link is Pass Through (PT). 

User name under which this link has been established. 
Application to which this link has been made. 


Gives the current status of the link. See Figure 9-3 
below. 


OPENING A LINK command has been issued but 
actual connection acknowledgement has not been 
received yet. 


ACTIVE Link is operating normally. 


CLOSING The link is being closed either normally 
(UNLINK command) or abnormally. 


FAILED The link has been abnormally disconnected. 
RMOS attempts to reconnect automatically five times. 


Gives the number of messages stored in the subfile 
when RMOS is operating in file mode. If RMOS is 
operating in message mode, the presence of 
"WAITING" in this field indicates that a message is 
ready to be received when the link is selected. While 
the link waits for a response from the operator, this 
number is highlighted. No more messages are sent 
over the link until the operator replies. 


TOTAL NUMBER OF LINKED SITES 
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Gives the total number of known links whatever their 
status. 
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FILE SPACE AVAILABILITY 
Indicates that RMOS is operating in file mode and 
gives the percentage of free space in the used file. The 
free available space relates to the current file size. No 
provision is made for any future increase in file size. 


NOLINK |< A 
LINK 
UNLINK 
5 TIMES FAILED 
FAILURE 
OPENING 
UNLINK 
ACTIVE CLOSING 
FAILURE 


Figure 9-3. Link Status Transitions 
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9.4.2 Global Requests Screen Layout 


This screen is displayed after you enter the command 


DISPLAY OPTION = GLOBAL REQUESTS. 


The screen shows you the list of REQUESTS sent by all LINKS for the current 
RMOS session and consists of one or several pages. 


DISPLAY GLOBAL REQUESTS 


WARNING : MESSAGE FLOW INTERRUPTED FOR XXX LINKS 


USER : syso 


EF O13) 56 


SITE : ssyy 


Figure 9-4. Display Global Requests 
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Field Descriptions 

n number of the current page. 

N total number of pages of the display (max. is 99). 

AUTO The display is automatically managed according to the 
time interval specified through the CONTROL 
command (default is 60 seconds). 
You control the screen manually by entering 
commands in a two-character control field. For more 
information, see the explanation of the CTL command. 

SITE Name of the site to which the link is made. 

USER User name under which the link has been established. 

APPL. Application to which this link has been made. 


"WARNING: MESSAGE FLOW INTERRUPTED FOR XXX LINKS" 


The second line indicates that a number of XXX links (>0) have stopped sending 
any more messages. These links are waiting for a response from the operator. For 
example, 


e page synchronization: "+++" 
e at system level: "S:" 
e eee 


On the global-status screen, the message count for such links is shown in reverse 
video. 


NOTE: 
To have a continuous flow of messages on a link in console mode, set PAGE 
MODE = 0 in the GCL user's profile. 


The other lines contain the requests (on one or several lines for each request) 
exactly as they are sent by the links. 


Catalogued requests: * AAI... 

(key) ** AAT1..... (repeated) 
Uncataloged requests: * LAL... 

(hour) ** 11.11..... (repeated) 
Questions: 11/..... (question number) 
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e Only links with pending requests are shown on the screen. 


e Ifno request is pending for any link, the screen is empty: the blinking line "NO 
PENDING REQUESTS" appears. 


e On the screen, links are sorted by alphabetical order. 
e Only the beginning (*..., 11/) of the requests is recognized. 


e A request is maintained for about four minutes on the screen, regardless of the 
action(s) that the operator may carry out to satisfy it. Whether the request is 
satisfied or not, it remains displayed on the screen. 


e An unsatisfied request is repeated every three minutes by the link. 


e This repeated occurrence activates the request for a further four minute period 
on the screen. 


e A request which has not been repeated within four minutes is discarded. It no 
longer appears on the screen. This is the case for a waiting link whose message 
flow has been interrupted. 


Note that filters must first be set up on sites to which a link is being made so that 
requests appear on the Global-Requests screen. 
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9.5 RMOS Error Messages 


9.5.1 Initialization Error Messages 


RMOS may issue the following error messages at initialization time. In some cases 
a return code can help detect the cause of the error. RMOS terminates after issuing 
the error message. 


RMO1 RMOS INITIALIZATION ERROR: NO SEMAPHORE AVAILABLE 
RC = return-code 
Meaning software error. 
Action Contact your Service Center. 
RMO2 RMOS INITIALIZATION ERROR: NO WORKSTATION AVAILABLE 
Action Check that you are not attempting to start more than 10 
RMOS processors; otherwise contact your Service 
Center. 
RMO3 RMOS INITIALIZATION ERROR: UNABLE TO READ DIRECTIVE 
Meaning software error. 
Action Contact your Service Center. 
RMO4 RMOS INITIALIZATION ERROR: UNABLE TO CREATE BUFFER 
RC = return-code 
Meaning Software error. 
Action Contact your Service Center. 
RMOS RMOS INITIALIZATION ERROR: UNABLE TO GET ENVIRONMENT 
RC = return-code 
Meaning software error. 
Action Contact your Service Center. 
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RMO6 RMOS INITIALTZATION ERROR: UNABLE TO GET CURRENT 
JOB IDENTIFICATION 
RC = return-code 


Meaning software error. 


Action Contact your Service Center. 


RMO7 RMOS INITIALIZATION ERROR: UNABLE TO GET CURRENT 
USER IDENTIFICATION 
RC = return-code 


Meaning software error. 


Action Contact your Service Center. 


RMO8 RMOS INITIALIZATION ERROR: UNABLE TO GET CURRENT 
SITE IDENTIFICATION 
RC = return-code 


Meaning software error. 


Action Contact your Service Center. 


RM10 RMOS INITIALIZATION ERROR: UNABLE TO CREATE RMOS DOMAIN 
RC = return-code 


Meaning software error. 


Action Contact your Service Center. 


RM11 RMOS INITIALIZATION ERROR: UNABLE TO START PROCESS pl 
RC = return code 


Meaning software error. 


Action Contact your Service Center. 
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9.5.2 
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Command Processing Error Messages 


RMOS issues these error messages whenever an RMOS command applies to an 
unknown object. Do not confuse them with the normal GCL command error 
messages. 


RM22 LINK ALREADY CONNECTED: COMMAND DISCARDED 
Meaning This link already exists. 


Action Check that the link exists by using the DISPLAY 
command and use the correct command. 


RM23 NO MORE SPACE AVAILABLE IN SESSION TABLE: COMMAND DISCARDED 


Meaning A LINK command has been issued and there is no 
more space in the user session table. 


Action Re-issue the command after terminating at least one 
previous user session. 


RM24 LINK UNKNOWN 
Meaning The specified link does not exist. 


Action Check that the link exists. 


RM25 LINK MUST BE DEFINED MORE PRECISELY 


Meaning The LINK name specified in the command is 
ambiguous. 
Action Specify precisely the user and/or application. 


RM26 NO SELECTED SESSION 


Meaning An INTERRUPT command has been issued and there 
is no currently selected link. Command makes no 
sense. 

Action None. 


RM27 LINK STATE "FAILED" 


Meaning A SELECT command has been issued on a link whose 
status is "failed". 


Action Re-issue command when the link has been 
successfully reconnected. 
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9.5.3 VCAM Error Messages 


RM31 LINK site/user/application 
CONNECTION REJECTED - reason 


This message is issued when a LINK command cannot be successfully executed. 
The reasons for rejection are: 


STATUS = V_REJECT (01) 
Action None. 


SYSTEM RESOURCE OVERLOAD (02) 
Action None. 


STATUS = V_ARGERR (03) 
Action None. 


LOCAL MAILBOX SATURATED (04) 
Action None. 


DESTINATION NOT SPECIFIED (05) 
Action None. 


STATUS = V_SYSTERR (06) 
Action None. 


BY REMOTE APPLICATION (07) 
Action Check the status of the remote network system. 


STATUS = V_ABNREJCT (08) 
Action None. 


DESTINATION NODE NOT OPERABLE (09) 
Action Check the status of the remote network system. 


DESTINATION NODE SATURATED (10) 
Action None. 


DESTINATION MAILBOX UNKNOWN (11) 
Action Remote application of a LINK command is not known 
on the remote site. 


DESTINATION MAILBOX NOT OPERABLE (12) 
DESTINATION MAILBOX SATURATED (13) 
DESTINATION APPLICATION SATURATED (14) 
DIALOG REJECTION (NEGOTIATION RESULT) (15) 


PRESENTATION REJECTION (NEGOTIATION RESULT) (16) 
Action (12-16) Check the status of the remote network system. 
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TIME OUT (17) 
Action Check the status of the Front End. 


ACCESS RIGHTS VIOLATION (18) 

Action Check the access rights of the specified 
USER/PROJECT/BILLING to the system/application 
on the remote site. 


SECURITY CHECKS FAILED (19) 
Action Enter the correct password at link time. 


DESTINATION NODE UNKNOWN (20) 

PATH TO DESTINATION NOT AVAILABLE (21) 

Action (20-21) Check the network generation parameter against the 
actual network configuration. 


USER ALREADY LOGGED (22) 
Action None. 


DUPLICATE STATION IDENTIFIER (23) 
Action None. 


STATUS = V_CLSREJCT (24) 
Action None. 


RM32 LINK site/user/application 
UNABLE TO CLOSE SESSTON 


Meaning Link is removed from RMOS link table. 


Action None. 
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Remote Multiplexed Operator Support (RMOS) 


RM33 LINK site/user/application 
UNABLE TO RECEIVE DATA - SESSION IS DISCONNECTED (01) 
UNABLE TO SEND DATA - SESSION IS DISCONNECTED (02) 
UNABLE TO RECEIVE IT - SESSION IS DISCONNECTED (03) 
UNABLE TO SEND IT - SESSION IS DISCONNECTED (04) 


Meaning An abnormal termination of the specified operation has 
occurred. An attempt is made to terminate the link 
session and then to reconnect automatically. 


Action None. If the problem persists, contact your Service 
Center. 


RM34 LINK site/user/appl 
REMOTE APPLICATION ABNORMALLY DISCONNECTED 


Meaning An abnormal disconnection has been received by 
VCAM. The connection is interrupted. RMOS will 
attempt to reconnect the link 5 times (once every 6 
minutes). 


Action None. If the problem persists, contact your Service 
Center. 
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9.5.4 File Processing Error Messages 


RMO9 RMOS MODE IS FILE: TEMPORARY FILE IS USED 
RC = return-code (01) 


Meaning Issued when RMOS is started using MODE = FILE 
option and the specified file is not found. In this case, a 
temporary file is created for the duration of the RMOS 
session. 


Action None. If you wish to use a permanent file, terminate 
this RMOS session and restart using a valid file name. 


RMO9 RMOS MODE IS MESSAGE: UNABLE TO ASSIGN FILE 
RC = return-code (03 


RMO9 RMOS MODE IS MESSAGE: UNABLE TO CREATE FILE 
RC = return code (02 


RMO9 RMOS MODE IS MESSAGE: UNABLE TO ALLOCATE FILE 
RC = return-code (04 


RMO9 RMOS MODE IS MESSAGE: UNABLE TO OPEN FILE 
RC = return-code (05 


Meaning (02-05) Because of file problems, RMOS will operate in 
MESSAGE mode. 

Action (02-05) If a file is needed, use the return code to detect the 
cause of the error (see the Error Messages and Return 
Codes Manual). 


RM53 UNABLE TO EXTEND RMOS FILE: SOME MESSAGES MAY BE 
LOST 
RC = return-code 


Meaning The maximum file size limit has been reached and the 
file cannot be extended any more. 


Action Delete the oldest messages in the largest subfiles for 
links which have not been selected. 
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RM45 


RM45 


RM45 


RM45 


UNABLE 


UNABLE 


UNABLE 


UNABLE 


Remote Multiplexed Operator Support (RMOS) 


LINK site/user/application 


TO OPEN SUBFILE 


RC = return-code (01) 


LINK site/user/application 


TO CLOSE SUBFILE 


RC = return-code (02) 


LINK site/user/application 


TO READ DATA FROM SUBFILE 


RC = return-code (03) 


LINK site/user/application 


TO WRITE DATA IN SUBFILE 


RC = return-code (04) 


Meaning (01-04) These error messages denote a problem in the subfile 


associated with the specified link. RMOS disables the 
file and will operate in MESSAGE mode. 

Note that if the incident occurred during a read/write 
operation, some messages may be lost. 


Action (01-04) Check the cause of the error using the Error Messages 


and Return Codes manual (file management). 
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9.5.5 Miscellaneous Error Messages 


RM20 RMOS INTERNAL ERROR 
RC = return-code 


Meaning An unexpected return code has been encountered 
within processing. Although processing is normally not 
interrupted, depending on the type of error, the results 
obtained subsequently may not be those expected. 


Action You are recommended to abort RMOS activity and 


take a dump. 


RM21 UNABLE TO READ GCL COMMAND 
RC = return-code 


Meaning An abnormal return code has been encountered in a 
GCL read procedure. 
Action Check return-code value and relevant explanations 


against GCL manuals. 


RM55 TERMINAL TYPE NOT SUPPORTED 
RC = return-code 


Meaning Self explanatory. 
Action RMOS must be operated from a FORM compatible 
terminal. 


RM56 UNEXPECTED RETURN CODE IN FORM PRIMITIVE 
RC = return-code 


Meaning RMOS malfunction. 


Action Processing may continue provided that the DISPLAY 
command is not used. 


RM57 DO YOU REALLY WANT TO QUIT RMOS ? 
(PLEASE ANSWER YES OR NO) 


Meaning Request confirmation for quitting RMOS. 


Action Answer "YES" or "NO". 
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10. Reconfiguration 


10.1 DPS 7000 Reconfiguration 


Reconfiguration for DPS 7000 until TA models included, is described in this 
chapter. The reconfiguration on DPS 7000/XTA and following models is presented 
in chapter 10.2. 


10.1.1 Overview 


The larger DPS 7000 systems with redundant components are very reliable due to 
the Reconfiguration product. Reconfiguration takes place automatically when 
there is a malfunction, and in other circumstances can be performed manually by 
the operator. 


It is possible to remove certain failed resources from the configuration without 
stopping processing. 


The system components can be acted upon in two circumstances: 


1. At system initialization (Static Configuration) 
A component can be excluded: 


— either automatically when the component cannot be initialized 


— or upon operator request for example when intermittent faults are not 
detected at initialization time or when a component needs to be reserved for 
a diagnostic operation at a future time; 

In bisystem mode the system components of the installation are distributed 

between the two systems via two reservation lists; 
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2. When the system is running (Dynamic Reconfiguration) 


— upon component failure, if a component becomes not operational it is 
automatically isolated. On redundant configurations the system remains 
running when possible. For example if a path to a device is broken because 
one of the components in the path becomes not operational an alternate 
path is found. 


— upon operator request, for example: 


to isolate a component where too many non fatal incidents arise, 
to exclude a component from a system to allocate it to the other system in a 
bisystem configuration, 
to insert a component in a system. 
For Reconfiguration purposes, a clear distinction must be made between a system 
and an installation : 


e Asystem is a set of resources controlled by one GCOS 7 Operating System. This 
includes Central Subsystem resources and Peripheral Subsystem resources. 


e An installation covers a DPS 7000 computer with peripherals which are 
connected to it. An installation is described by an Installation Resource Table 
(RT). 


A redundant installation can be used in two ways : 


e all the resources of the installation are put together and controlled by a single 
GCOS 7 Operating System : mono-system mode, 


e Central Subsystem resources are split in two parts; each part running a separate 
GCOS 7 Operating system : bi-system mode. 
Peripheral resources may be accessible by only one system or by both systems 
depending on the physical connections. 
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10.1.1.1 System Architecture and Resources 


The general architecture of the system from the Dynamic Reconfiguration point of 
view is the following: 


aio : 
Level n a 
Mu Hi Cpu DZ | lop i 
Level 0 Level 0 ae ! | 5 ': vA 
v . 
Level1 | lop oe 
LUT TTT] Pa 
Level 0 | lop | <« » 
css (Pc's) 
PSS 
Pcu | 
7 i as | A 
Device b> -) 


Figure 10-1. System Architecture 

The system is structured in two major parts: 
e the Central SubSystem (CSS), 

e the Peripheral Subsystems (PSS). 


The Peripheral SubSystems are connected to the Central SubSystem through 
Physical Channels (PC). 
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Central SubSystem 
It is made of the following resource types: 


e Main Memory Units (MU). 
e Central Processors Units (CPU). 
e Input-Output Processors (IOP). 


The redundancy of major resources provides a better availability. 


Some resource classes may be organized into several levels. In this case every 
action performed at a given level is propagated at the lower levels and to the PSSs 
which are connected to it. 


Peripheral SubSystem 
The Peripheral SubSystem includes: 


e the controllers: Peripheral Control Units (PCU), 
e the peripheral devices. 


There exists several types of controllers, each of them managing different kinds of 
peripheral devices. A controller is referred to by its external identifier which has the 
following format: 


e MCxx for Mass storage Controllers which manage disk devices. 
e TCxx for Tape Controllers which manage magnetic tape units or cartridges. 


e UCxx for Unit record Controllers which manage "slow" peripherals: printers or 
local telecom lines. 


e CCxx for Communication Controllers which allow the connection of Datanets 


A peripheral device can be connected to several PCUs, thus providing several 
access paths to it from the CSS. This allows to balance the IOs between the access 
paths according to the actual load of the various components in the access path, and 
provides a better availability in case of failure of a component in an access path: an 
alternate path is automatically chosen by the system. 
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10.1.1.2 When and How to Configure or Reconfigure a System 
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Static Configuration of the CSS resources takes place at system initialization. The 
detailed operating actions depend on the machine, they are described in the 
appropriate Operator's Guides: 


e 77 A1 71UU for DPS 7000/Ax. 

e 77 A1 54UU for DPS 7000/2xx and DPS 7000/3xx. 

e 77 A1 81UU for DPS 7000/5xx and DPS 7000/7xx. 

e 77A1 65US for DPS 7000/4xx/Cxx/8xx/Dxx/Mxx and DPS 7000/MTxx. 

The Dynamic Reconfiguration of the CSS resources takes place when the system is 


running. 


On DPS 7000/Ax, DPS 7000/2xx, DPS 7000/3xx, reconfiguration is performed 
through Service Processor commands and is described in the appropriate manuals: 


e 77A1 71UU for DPS 7000/Ax. 
e 77 A154UU for DPS 7000/2xx and DPS 7000/3xx. 


On DPS 7000/4xx, DPS 7000/5xx, DPS 7000/7xx, DPS 7000/8xx, and 
DPS 7000/MTxx, reconfiguration is performed using GCOS 7 commands as 
described in this section of the manual. 


The Reconfiguration of PSS components: 


e is always performed when the system is running, 
e is performed through GCOS 7 commands, 


e is described in the present Chapter of this manual. 
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10.1.2 


Reconfiguration of Central Subsystem 


The Dynamic Reconfiguration takes place when the system is running; it is 
activated: 


e either automatically upon detection of an Hardware incident, 
¢ or upon operator command. 


The result of the reconfiguration depends upon the type of the resource and the 
state of the resource at the time the reconfiguration occurred. 


10.1.2.1 CSS Resources 


Every resource has an external identifier which is used to designate it in operator 
commands and messages. The general format of the external identifier is YYxx 
where YY designates a resource class and xx designates a resource name (number) 
inside the class. 


Central Processor Units 


There are several types of Central Processor Units (see also Section 5.10 Domain 
and CDP, Customer Dedicated Processor, Overview): 


e IPxx, the Standard DPS 7000 Processors, 


e EPxx, type 1 extended processors, the High Relational Performance Processors 
present on some DPS 7000 systems 


e FPxx, type 2 extended processors, and GPxx, type 3 extended processors. 


Every CPU can be inserted or removed; however, since the system will remain 
operational only if at least one IPxx is available, the MDHW command refuses to 
remove the last IPU. 


Main Memory Units 


The Software provides a logical view of the Main Memory through Memory Units 
(MUxx). An MUxx is a set of contiguous memory space from the addressing point 
of view. 


The Service Processor is used to manipulate physical memory boards (HMxx). You 
can use the CFG utility of the Service Processor at system initialization to add an 
HMxx to the configuration of a system, remove it, or exclude it from the 
configuration. 
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There is no direct correspondence between the MUs and the HMs because a MUxx 
may be spread over several physical memory boards. 


On the DPS 7000/8x0/Dx0/Mx0/MTxx, however, there is a direct correspondence 
between the MUs and the HMs. 


Example 


e Assume that HM02, HM04, HM06, HMO08 are present in the installation. 
e System SO has been configured with HM02 and HM04. 
e HMO06 and HM08 have been excluded. 


The DHW MU command on SO system displays the following: 


MUOO IN 

MUO1 OUT (NOT ACCESSIBLE) 
MU02 OUT (NOT ACCESSIBLE) 
MU03 OUT (NOT ACCESSIBLE) 


MU02 and MU03 are not accessible because they correspond to HM06 and HM08 
which have been excluded. 


Actually the two physical memory boards HM02 and HM04 are mapped on to 
MU00 memory unit in the allocated (IN) state. The MU01 memory unit is an 
"place holder" unit and cannot be manipulated by the operator commands. 


MU01 is displayed as "not accessible" because it is spread within HMO02 and 
HM04 memory boards which are interleaved. 


The mapping of HMs on to MUs can dynamically change. 


To insert the HM06 memory board after repair, the exclusion list must be modified 
by the CFG utility of the Service Processor in order to remove HMO06 from the 
exclusion list; a following DHW command issued on GCOS 7 will display: 


MUOO IN 

MUO1 OUT (NOT ACCESSIBLE) 
MU02 OUT (ALLOCATABLE) 
MU03 OUT (NOT ACCESSIBLE) 


A MDHW MU02 IN will make the memory unit available to GCOS 7. 


A MUxx resource cannot be dynamically removed from a system. 


10-7 


GCOS 7 System Operator's Guide 


Input Output Processors 
There are two types of Input Output processors from the Software point of view: 


IOxx Input Output controllers. 
PXxx Physical channel multipleXed units. 


They are organized hierarchically in two levels. The IOxx are usually at the higher 
level. Depending on the DPS 7000 series, one of the two levels may be absent. 


When a reconfiguration action (manual or automatic) takes place for a resource, the 
action is propagated on to the lower levels up to the physical device. 


On DP 7000/4xx/5x0/7xx/8x0/Dx0/Mx0/MTxx series, the hardware architecture 
makes a distinction between: 


e the proper CSS components : IPxx, EPxx, FPxx, GPxx, HMxx gathered into the 
Central SubSystem (CSS), 


e the Input Output Components: I[Uxx, XAxx, MBxx, PXxx gathered into the 
Input Output SubSystem (IOSS). 


IOPs are allocated to a system at IOSS level i.e. the IOxx and the related PXxxs. Its 
is not possible to allocate an IOxx to system SO and a related PXxx to system S1. 


Refer to the relevant Operator's Guide for a detailed definition of the hardware 
components. 


The GCOS 7 software provides a simplified view of the Input Output SubSystem 
in order to focus on the major resources from the reconfiguration point of view. 
Roughly 


e IOxx resource corresponds to the XAxx hardware component, 
e PXxx resource corresponds to the PXxx hardware component. 
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10.1.2.2 Resource States 
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The main states of Central SubSystem resources are listed hereafter. For each of 
them, a description of the state is given as well as the result of a MDHW command. 


IN 
Meaning: The resource is allocated to the system 


OUT action: The resource is made unavailable to the system. Depending on the 
resource type and the context, the OUT action may be accepted or rejected. 


OUT 
Meaning: The Unit is not allocated to the system 


IN action: The resource is made available to the system if it can be successfully 
initialized. 


OUT(BY SYSTEM) 


Meaning: The Unit is not allocated to the system; it has been deallocated by the 
system because of an abnormal event. 


IN action: The resource is made available to the system if it can be successfully 
initialized. 


OUT(BY OPERATOR) 


Meaning: The Unit is not allocated to the system; it has been deallocated by an 
operator command MDHW. 


IN action: The resource is made available to the system if it can be successfully 
initialized. 
OUT(FATHER OUT) 


Meaning: The Unit is not allocated to the system, it has been deallocated because 
one of the upper resource is deallocated. 


IN action: The request is rejected as long as the upper resource is deallocated. 
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OUT(NOT ACCESSIBLE) 


Meaning: The Unit is not allocated to the system, usually it has been inserted in the 
exclusion list. 


IN action: rejected 


OUT(ALLOCATED TO ANOTHER SYSTEM) 


Meaning: The Unit is not allocated to the system, it is allocated to the other system 
in a bisystem configuration. 


IN action: rejected 


OUT(NOT INSTALLED) 
Meaning: The Unit is not present in the installation 


IN action: rejected 
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10.1.2.3 Machine Incidents 
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The GCOS 7 Software is warned by the Hardware of any abnormal event. The 
Software analyzes the error and tries to recover it keeping the system running 
possibly in a degraded mode. 


For every error, a message is sent to the operator and the event is logged in the 
SYS.ERLOG file. Some events will require a maintenance action. 


If the reported event is a permanent failure: 


e the failed unit is deallocated as well as the downward related resources, 


e the system performs recovery actions. The level of success of recovery actions 
depends upon the nature and the context of the incident. 


Examples 


When a CPU becomes unavailable, the system tries to resume on another CPU the 
execution of the process which was running on the faulty CPU provided that there 
exists at least two CPUs in the configuration: 


e if the context of the process can be retrieved, the process execution will be 
resumed on another CPU, 


e if the context of the process cannot be retrieved, and the process was not 
executing critical software system functions the process is aborted, 


e if the context of the process cannot be retrieved and the process was executing 
critical software system functions, a System Crash is issued. 


When a failure arises in an IOP, the failure may be 


e a total failure. In this case the IOP is deallocated as well as the downward related 
resources (controllers and devices) if the failed IOP was in all the active paths to 
the resource, 


e apartial failure. In this case the system starts a recovery sequence for each 
downward related controller. If at least one controller is recovered, the IOP stays 
in the current system, otherwise it is removed. 


The Console Messages Directory (47 A2 61UU) gives an explanation of the 
messages with the prefixes AV and AW that are issued to report the events to the 
operator console. 
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10.1.2.4 GCOS 7 Reconfiguration Commands (MDHW and DHW) 


The MODIFY HARDWARE (MDHW) and DISPLAY HARDWARE (DHW) 
commands are used by the operator to reconfigure system hardware, after 
initialization, while the system is running under GCOS 7. This is known as 
dynamic reconfiguration. The commands cover two activities: 


e modification of the state of hardware resources (MDHW command - Chapter 8 
Description of the Operator Commands), 


e display of the state of hardware resources (DHW command - Chapter 7 
Description of the Operator Commands). 


These commands apply to all hardware resources - Central Subsystem units, 
peripheral controllers and peripheral devices. 


For more details, refer to the complete explanation of MDHW and DHW in 
Chapters 7 and 8 Description of the Operator Commands. The Console Messages 
Directory gives an explanation of the messages with the prefixes AV and AW that 
are issued concerning these commands. 


10.1.2.5 Dynamic Reconfiguration and System Restart 
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When a system is stopped then restarted after previous dynamic reconfiguration 
operations have taken place, the following rules are applied: 


e in the case of Reload, the system is restarted with the current configuration: 
dynamic reconfiguration operations remain valid. 


e in the case of Reinitialization: 


— if the restart is automatic (REPEAT option of MDRSO command and INIT 
option of TSYS command), the system is restarted with the current 
configuration: dynamic reconfiguration operations remain valid 


— if the restart is manual, the reinitialization is always performed with the 
reservation list of CFG Service Processor utility. 


Example 


Assume that SO system has been initialized with CPUs IPO0 and IPO1 in 
reservation list. 


S1 system has been initialized with IP02 in reservation list. 


IPO1 has been dynamically reallocated to S1 system by MDHW commands on SO 
and S1. 
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The IPxx allocated to S1 system after restart depends on the performed operations. 
the following table depicts the possible situations. 


Table 10-1. Dynamic Reconfiguration 


option stopped by | restarted by at restart 
IPO1, [P02 Reload with units allocated at the 
Repeat TSYS time the system was stopped. 
Repeat TSYS list. 


No TSYS INIT | Automatic IPO1, [P02 Reload with units allocated at the 
Repeat time the system was stopped. The 
NOREPEAT option of MDRSO 
command is meaningless. 
Repeat Crash or Automatic IPO1, IP02 Automatic reload with units 
ee ioe allocated at the time the system 
was stopped. 
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TSYS INIT | Automatic IPO1, [P02 Automatic reinit with units 
allocated at the time the system 
was stopped. 
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10.1.3 Reconfiguration of Peripheral Subsystems 


10.1.3.1 Peripheral SubSystem 


In general terms, a Peripheral Subsystem is a set of devices and controllers. 
The devices belong to the same family e.g. disk or magnetic tape. 

There is one controller per Physical Channel. 

Each device can be connected to one or two controllers. 

A controller is connected to one Input/Output Processor. 


This is a logical representation of peripherals. Depending on the nature of the 
peripheral the logical representation can be the same as or different from the 
physical architecture in terms of hardware components. 


For example: 


With a Bi-PSI controller, the mass storage subsystem is connected to the CSS 
through two physical channels, the physical controller is represented by two logical 
controllers, one for each physical channel. 


With MSP SCSI Subsystem: 
e disks and cartridges can be connected on the same SCSI bus, 


e MSP physical board has the IOP, controller and physical channel functions. 


Figure 10-2 gives an example of physical representation and logical representation 
of peripherals on the same SCSI bus connected to two MSPs. 
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Figure 10-2. Peripherals - Physical and Logical 


47 A2 53US 


10-15 


GCOS 7 System Operator's Guide 


Concerning the Peripheral Subsystems, the following aspects must be considered: 


e the physical connections of the devices to controllers and of the controllers to 


installations, 


e the number of simultaneous Data Transfers which can be performed on a set of 


devices: Level Of Simultaneity (LOS), 


e the number of access paths from a system to a peripheral device, 


e the level of sharing of the volumes when the device can be accessed by several 


systems, 


e the level of redundancy of the system. 


10.1.3.2 Physical Connections 
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A device can be connected to | or 2 controllers. 


Some Controllers can support up to 4 channel ports which connect him to one or 
several installations. In an installation, at most two channels can lead to the same 


controller. 


In the description of an installation (Installation Resource Table: IRT) a controller 
is described as a set of logical controllers, one for each physical channel which 
connects the controller to the installation. Thus the IRT of the installation may 


provide a partial view of the Peripheral Subsystem. 


Example : Cartridge Subsystem 


| Installation 3 


07 : 08 


Installation 4 | | Installation 2 | 
( fe & \ 
zr Ft os ‘ 
Controllers 01 : 02 : 03 : 04 05 : 06 : 
CcTo1 ) 


CeTo2 )»——— 


Figure 10-3. Example of Cartridge Subsystem 
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IRT of installation 1 TCO1, TCO7, CTO1, —_ logical controllers.cartridge 
declares CT02 devices. 


IRT of installation 2 TC03, TC04, TCO5, logical controllers.cartridge 
declares TC06, CTO1, CTO2 devices. 


IRT of installation 3 TC02, TCO08, CTO1, _ logical controllers.cartridge 
declares CT02 devices. 


Remember that some installations can be split in 2 separate systems, each of them 
running their own GCOS 7 Operating System. The two systems of a bi-system 
installation use the same IRT, thus some devices or paths, although they are known 
by both systems, may be not accessible on one of the systems. 


For Disk Subsystems: 


e The maximum number of physical channels for a controller is 2. 


e Each channel can be connected to the same installation or to 2 separate 
installations. 


e A disk can be accessed by at most 2 systems belonging to the same installation 
or to 2 different installations. 
For Tape Subsystems: 


e The maximum number of physical channels for a controller is | (but see later 
Dual LOS). 


e On some Tape Subsystems (MTS4572) a manual switch gives the possibility to 
connect the physical channel to one installation or to another one, thus making 
the set of tape devices alternatively available on the two installations. 


For Cartridge Subsystems: 


e The maximum number of physical channels for a controller is 4. 


e At most 2 physical channels of a controller can be connected to one installation, 
the other channels can be used to connect the controller to other installations. 
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Level of Simultaneity (LOS) 


Single LOS 


Only one Data Transfer can be handled at a time. The peripheral devices are 
connected to only one controller. 


Dual LOS 


Two Data Transfers can be handled at a time on two different devices; two 
possibilities exist: 


e Each device is connected to two controllers; (this is the only possibility for disk 
subsystems). 


e Each device is connected to one controller but the controller is able to handle 2 
simultaneous IOs and the controller is connected to the installation(s) by at least 
2 physical channels. 
In this case the controller is represented as 2 independent controllers with 
consecutive external identifiers (TCnn, TCnn+1). 


MCO1 MCO1 MC03 
2 <2 
soe 802 
<MSon | _MSnn 
Single LOS Dual LOS 


Figure 10-4. Level of Simultaneity (LOS) 
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Access Paths From a System To a Device 


We consider here the access paths as seen by one system. The device may be also 
accessible by some other systems in the same installation or in independent 
installations. 


Single Access 


The device is accessed by only one path through a single controller. 


Dual Access 
The device is accessed by 2 paths; two possibilities exist: 


e Through 2 independent controllers: 
— Ifa controller or physical channel fails, the device remains accessible. 


— The system launches the IOs on one path or the other one, depending on the 
actual load of the controllers. 


e Through the same Bi-PSI controller: 


— This configuration is interesting on an installation which can be split in two 
separate systems. 


— Ifthe controller fails, the device is no longer accessible. If one physical 
channel fails, the device remains accessible. 


— If the two paths are valid (IN state), the system launches the IOs always on the 
same path for a given device, the other path will be used if the first path 
becomes unavailable (SPARE path); some IOs can be launched on the 
physical channel implied in the SPARE path, they are related to another 
device. 


More Than Two Access Paths 


The device is accessed through two controllers, at least one controller is connected 
to the system by two physical channels. 


If all the paths are valid, the system actually uses one physical channel on each 
controller to launch IOs on a given device; the other paths are SPARE for the 
device. 
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This facility is available only on Disk Subsystems and Cartridge Subsystems. 
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—— Ms02 > <MS02 
———( MSnn ) © MSnn > 
Single Access Dual Access 
SO System | SO System | 
MCO01| MCO2 MC01|MC02 MC03) MC04 
© MS01 > —— sot) 
soz » <Ms02_-—— 
© MSnn_ © MSnn > 
Dual Access - BIPSI Four Access Paths 


Figure 10-5. Access Paths 
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Reconfiguration 


A device and the associated volume are shared if they can be accessed by several 
systems. The systems can be on independent installations or can belong to the same 
installation in bi-system mode. 


There exist two types of sharing: 


Static sharing 


Dynamic sharing 


During a long period of time, the device is in exclusive 
use by one system. The other systems cannot access 
the device; the device is said "SEIZED BY ANOTHER 
SYSTEM". 

This is the only valid type of sharing available for 
magnetic tapes and cartridge devices. 


The device can be accessed by two systems. An 
hardware mechanism prevents IOs on the same device 
to be simultaneously issued by two different systems. 
Software locks mechanisms at file level allow to 
guarantee the file consistency. 

Dynamic sharing is available only for disk devices. 


Particular attention must be paid not to mix static sharing and dynamic sharing for 
the same volume; this could result in the system being completely tied up due to a 


deadlock. 


Regarding the physical connections, device shareability is possible at several 


levels : 


e sharing at controller level: 
the device is connected to one controller and the controller is connected to two 


systems or more. 


e sharing at device level: 


the device is connected to two independent controllers each controller being 
connected to only one system. 


e sharing at controller and device level: 
the device is connected to two controllers and each controller is connected to 


two systems or more. 
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| SO System || $1 System | | SO System || S1 System SO System | S1 System | 
a 
| 
MCO01 | MCO2 | MCO1 MCO03 MC01 | MC02|| MCO3 | MC04 
MSO’ ——<ws01) — “sot — 
<Ms02) —CMso2)— M802) 
MSnn)) MSnn)}— —<MSnn)— 
At Controller level At Device level At Both levels 


Figure 10-6. Device Sharing 


For a detailed description of device sharing, refer to the Coupled System User's 
Guide. 


Redundancy 


When a unit fails, the reconfiguration is possible only if another unit of the same 
type can play the role of the failed unit. This is known as REDUNDANCY. 


In the access to a device by a system, several units are usually implied: 
Input/Output processors, Controllers, Physical Channels. The availability of the 
system in case of unit failure depends on the degree of redundancy of all the units; 
when an alternate path to the device can be found whatever the failed unit, the 
system is said fully redundant. 
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10.1.3.3 Device States and Device Path States 
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To find out the status of Peripheral SubSystems, the operator uses the MDHW 
command. This command can display the status of the peripheral devices or the 
status of paths which lead to peripheral devices. 


The state of a device indicates: 


e ifthe device can be accessed by the system, 
e the name of the media which is presently mounted on the device, 
e what is the present usage of the media by the system. 


The device states are described in Chapter 6 Peripheral Operations. 


The state of a device path indicates if a device path is usable or not, actually used 
or not, by a system. The possible device path states are: 


IN (READY) The path is fully operational and currently usable by 
GCOS. 
IN (SPARE) The path is operational but is not currently used by 


GCOS. It corresponds to one of the two physical 
channels of a BiPSI controller. 


OUT (BY OPERATOR) | The path is not usable; it was put out of the 
configuration by a MDHW xCnm.dvnm OUT 
command. 


OUT (DEVICE OUT) The path is not usable, the device dvnm being out of 
the configuration for maintenance purpose or because 
the device is statically shared and presently used by 
another system. 


OUT (CONTROLLER OUT) 
The path is not usable, the controller xCnm or an upper 
IOP being out of the configuration. 


OUT (NOT ACCESSIBLE) 
The path is not usable by the current system because a 
bisystem session has been initiated on the installation 
and the physical channel related to the path is 
connected to an IOP which has been allocated to the 
other system. 


OUT (BY SYSTEM) The path is out of the GCOS configuration due to a 
controller/device failure detected by the system. 
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Example 

SO system ! S1 system 

! 1000 ! 1001 ! 
06 07 03 04 
MCO06 | MCO07 MCO03 | MC04 


01 


02 © Ms02 > 


Assume that: 


e The installation has been initialized in a bi-system session. 

e MSO1 is dynamically shared between SO and S1 systems. 

e MS02 is in exclusive use by S1 system (device OUT on SO, device IN NSHR 
on S1). 


The display of device paths on both systems SO and S1 gives the following results: 


On SO system: 

MC06.MS01 IN (READY) MC03.MSO01 IN (READY) 

MC07.MS01 OUT (NOT ACCESSIBLE) MC04.MS01 OUT (NOT 
ACCESSIBLE) 

MC06.MS02 OUT (DEVICE OUT) MC03.MS02 OUT (DEVICE OUT) 


MC07.MS02 OUT (NOT ACCESSIBLE) MC04.MS02 OUT (DEVICE OUT) 
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On S1 system: 
MC06.MS01 OUT (NOT ACCESSIBLE) MC03.MS01 OUT (NOT 


ACCESSIBLE) 
MC07.MS01 IN (READY) MC04.MSO01 IN (READY) 
MC06.MS02 OUT (NOT ACCESSIBLE) MC03.MS02 OUT (NOT 

ACCESSIBLE) 
MC07.MS02 IN (READY) MC04.MS02 IN (READY) 


10.1.3.4 Peripheral Incidents 


The system behavior in case of peripheral incident depends on the nature of the 
incident and the peripheral configuration. 


Some incidents require a manual intervention by the operator. For example when a 
volume is dismounted while being used by a running job. 


In redundant configurations where a device is accessible by several paths, the 
system manages path switching automatically in the event of a fault occurring. 


In case of an incident on the path to a device, the failed component (controller of 
physical channel) is isolated (OUT) if it cannot be recovered. When a SPARE path 
exists, it is made READY. The I/O operations under way are automatically taken 
up on an alternate path if such a path exists and if the I/O is re-executable. 


Note, however, that when a device is sharable, an interrupted I/O is never retried on 
an alternate path of the same system. This is because it cannot be guaranteed that 
the retry operation will not be interfered with by another I/O started from another 
system. 


If the failed path was the last available one, the I/O terminates abnormally and the 
device is isolated (OUT). 


The operator is warned by one or several messages of every incident and its 
consequences. The Console Messages Directory gives for each message a 
description of the possible reasons of the incident as well as the possible corrective 
actions. 
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Example 
SO System 
06 07 03 04 
MCO6_ MCO07 MCO03 MC04 
= <MSOt 
<MS02 > 
<Msnn_> 


Assume the device MSO1 is accessible by 4 access paths through 2 Bi-PSI 


controllers. 


The DHW MSO1 PATH=1 command gives the following result: 


MCO06 .MSO1 IN (READY) 
MCO7.MSO1 IN (SPARE) 
MCO3 .MSO1 IN (READY) 
McO04 .MSO1 IN (SPARE) 


If a serious failure makes the first controller (MC06/MC07) unavailable, the 


following messages are displayed: 


Hh 


) 
) 
) 
) 


hh.mm MC06 PSI0O6 FAILED 
hh.mm MC06 OUT (BY SYSTEM) 
hh.mm MCO7 PSIO7 FAILED 
hh.mm MCO7 OUT (BY SYSTEM) 


The MSO1 device remains accessible through the second controller (MC03/MC04). 


A display of the MSO1 device paths gives the following results: 


MC06.MSO1 OUT (CONTROLLER OUT) 
MCO7.MSO1 OUT (CONTROLLER OUT) 
MCO3 .MSO1 IN (READY) 
MCO04 .MSO1 IN (SPARE) 
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The OLTDs can be used to diagnose the failed unit and the operator can use the 
MDHW IN command to reinsert the unit after it has been repaired. 
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When a device becomes inaccessible while being used, the following situations can 
arise: 


e The volume which was mounted on to the device is removable. 
The volume can be dismounted and mounted on another device of the same type: 
the processing of the job which was using the volume will automatically resume. 
If the operator does not want to mount the volume on another device, he can 
issue a CANCEL REQUEST (CR) command in response to the RECOVER 
request. 


e The volume which was mounted on the device is not removable and contains 
only user files. 
The jobs which were using the device are aborted. 


e The volume which was mounted on the device is not removable and contains 
BKST files. 
The system will terminate with a system crash. A dump is available if the 
implied volume does not contain the system backing store. 


10.1.3.5 GCOS 7 Reconfiguration Commands (DHW and MDHW) 
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The MODIFY HARDWARE (MDHW) and DISPLAY HARDWARE (DHW) 
commands are used by the operator to act upon peripheral elements : controllers/ 
physical channels, device paths and devices. The commands cover two activities: 


e modification of the state of hardware resources (MDHW command - Chapter 8 
Description of the Operator Commands), 


e display of the state of hardware resources (DHW command - Chapter 7 
Description of the Operator Commands). 


The MDHW command can be used to : 
e isolate for diagnostic purpose a unit or path where too many incidents arise, 


e insert a unit after it had been repaired, 
e modify the type of sharing of a volume in a Coupled System environment. 


The modification of the type of sharing implies operator actions on both systems. 
Whatever the transition state, from static to dynamic or conversely from dynamic 
to static, the device must be removed (MDHW OUT) from both systems before 
being inserted: 


e on one system (static sharing) by the MDHW IN command issued on one of the 
two systems, 


e on both systems (dynamic sharing) by the MDHW IN SHR command issued on 
both systems. 


If this method is not followed, it may result in a system deadlock. 
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For more details, refer to the complete explanation of MDHW and DHW in 
Chapters 7 and 8 Description of the Operator Commands. 


In some circumstances the action requested by a MDHW command cannot be 
immediately satisfied. The main cases are : 


e an OUT request is issued for a device which supports a volume presently used 
by a running job, 


e an OUT request is issued for a controller and this controller is implied in the 
only access path to a device which supports a volume presently used by a 
running job, 


e an IN request is issued for a device which is seized by another system. 


The processing of the request will resume as soon as the pre-emption condition 
disappears. 


Every Reconfiguration command displays one or several messages. The messages 
issued in response to a MDHW command give the status of the requested action: 
successful or unsuccessful or delayed with the cause of the result if not successful. 
The Console Message Directory gives a detailed explanation of each message. 


10.1.3.6 Dynamic Reconfiguration and System Restart 


When a device or controller is taken out of the system configuration by an MDHW 
OUT command, this OUT state is recorded in the SYS.ERLOG Control Records. 


When a device or controller is put back in the configuration by an MDHW IN 
command, the OUT state is reset in the SYS.ERLOG Control Records. 


GCOS 7 Restart 


At GCOS 7 restart, ERLOG retrieves from the Control Records the previous 
device/ controller states and restores them. The following rules apply: 


1. Adevice is taken out of the configuration if it was previously out and if the 
volume mounted on it is nota BKST/SHARED/RESIDENT volume or if it 
not allocated to a job. 


2. ERLOG tries to seize sharable devices not currently shared, if they were not 
previously out of the configuration or if they were previously out but are now 
mounted with a RESIDENT volume. 
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3. Acontroller is taken out of the configuration if it was previously out of the 
configuration and if it is not connected to: 


— adevice allocated to a job with no other path left; 
— a device supporting a BKST/SHARED/RESIDENT volume with no other 
path left. 


Reconfigured System 


At GCOS 7 restart on a reconfigured system, the rules for device/controller 
restoration are: 


1. If the operational configuration matches an old configuration recorded in 
SYS.ERLOG, the information concerning that configuration is retrieved from 
the file and used to restore device/controller states. 


2.  Ifitis anew configuration or if the SYS.ERLOG file has been automatically 
re-initialized: 


— all sharable MS devices are taken out of the configuration except those with 
a BKST/SHARED/RESIDENT volume and those allocated to a job. 


— other devices/controllers are presumed to be IN the configuration and the 
tule (2) is applied to seizable devices. 


SYS.ERLOG Unavailable 


If at GCOS 7 restart the SYS.ERLOG file is unavailable, ERLOG does not modify 
device/controller states, i.e. there is no taking out of the configuration and no 
seizure. 
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10.2 Reconfiguration on DPS 7000/XTA models. 


10.2.1 Overview 


A DPS 7000 /XTA is a Bull platform based on Intel Architecture managed by 
WINDOWS operating system (refer to chapter 2). The Largest models have 
redundant hardware components . 


V7000 is a Bull software component that allows to run GCOS 7 on DPS 7000 
/XTA. It is composed of a core part and a System Administration Manager (SAM). 
The first one is similar to firmware and the SAM corresponds to the Service 
Processor functions of previous DPS 7000. 


No change occurs in GCOS 7 architecture to run on DPS 7000/XTA. The only 
difference is that some GCOS 7 resources are now virtual because they are mapped 
on physical resources managed by WINDOWS™. 


As described in 10.1, GCOS 7 resources reconfiguration still takes place 
automatically when there is a malfunction, and in other circumstances can be 
performed manually by the operator. 


It is possible to remove certain failed resources from the configuration without 
stopping processing. 


The DPS 7000 /XTA configuration envelope depends on the model bought by the 
customer. The configuration is then defined inside this envelope by Bull support 
people according to the customer needs. 


The resources of this configuration can be acted upon in two circumstances: 


1. At system initialization (Static Configuration) 
A component can be excluded: 


— either automatically when the component cannot be initialized 


— or upon operator request before initialization time or when a component 
needs to be reserved for a diagnostic operation at a future time; 


2. When the system is running (Dynamic Reconfiguration) 
— upon component failure, if a component becomes not operational it is 


automatically isolated. On redundant configurations the system remains 
running when possible. 


— upon operator request, for example: 


to isolate a component where too many non fatal incidents arise, 
to insert a component in V7000 configuration. 
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There is no bisystem operation available. 
There is no disk sharing available on DPS 7000/XTA models. 
DPS 7000 /XTA Architecture and Resources 


The general DPS 7000 architecture is kept for DPS 7000/XTA, so we have the 
following from the Configuration and Reconfiguration points of view: 


IO (1OP level 1) 


Cc 
MU (level 0) CPU (level 0) 
PXU (IOP level 
Controllers 
P 
S 
5 


Devices 


Figure 10-7. DPS7000 /XTA : GCOS7 System Architecture 


On DPS 7000/XTA, PXU are typed according to the peripherals that are related to 
them. There are four PX types : 


Disks 
Cartridges 
Printer 
Telecom 


Only one telecom controller can belong to a given IOP. 
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The system is structured in two major parts which are composed of physical or 
logical (V7000 software components) resources: 


e the Central SubSystem (CSS), 
e the Peripheral Subsystems (PSS). 


The Peripheral SubSystems are connected to the Central SubSystem through 
Physical Channels (PC). 


Central SubSystem 


It is made of the following resource types: 


CSS resources Physical/Logical Comment 
Main Memory Units Logical Windows virtual Memory range 
(MU) reserved to GCOS7. 
Central Processors Units | Physical Intel processors dedicated to 
(IP) GCOS7 
Input-Output Processors | Logical V7000 software components 
(IO and PX) dedicated to IO operations 


Each IOP is a WINDOWS™ process in charge of managing up to 8 PXU. Each 
PXU is a WINDOWS™ thread in this process. 


CSS IOP resources are organized into several levels. Every action performed at a 
given level is propagated at the lower levels and to the PSS resources which are 
connected to it. 


PXU resources are specialized upon the device type they controlled. 
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Peripheral SubSystem 
The Peripheral SubSystem includes: 


e the controllers: Peripheral Control Units (PCU), 
e the peripheral devices. 


There exists several types of controllers, each of them managing up to 4 peripheral 
devices. A controller is referred to by its external identifier which has the following 
format: 


e MCxx for Mass storage Controllers which manage disk devices. 
e TCxx for Tape Controllers which manage cartridges. 


e UCxx for Unit record Controllers which manage "slow" peripherals: printers or 
local telecom lines. 


e UCx0 for Communication Controllers which allow the connection of Virtual 
Communication Processors and DSA network. This controller manages up to 6 
or 8 pairs of LT. 


PSS resources Physical/Logical Comment 

PCU / Controller Logical V7000 software belonging to 
a PX thread 

GCOS 7 Disk devices Logical WINDOWS™ NTFS file 

GCOS 7 Cartridge devices | Physical Cartridge device connected to 
platform 

GCOS 7 Printer devices _| Physical Printer device connected to an 
USB port or serial port 

GCOS 7 LT (telecom ) Logical Managed by VCP7 and OCS 


V7000 always uses specific WINDOWS™ APIs to access GCOS 7 devices, even 
for those that are qualified as “Physical” in the frame above. 
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10.2.1.1 When and How to Configure or Reconfigure a System 


On DPS7000/XTA configuration is first defined and set active by Bull according 
to the model and the customer needs. 


Static Configuration of the CSS resources takes place at V7000 initialization.. 
The number of CPU and the memory dedicated to GCOS 7 are checked versus 
platform physical resources when V7000 starts. So, some GCOS 7 processors 
(IP) or memory units (MU) may be excluded when V7000 starts : 


— there must be at least the same number of processors left for WINDOWS than 
the number of processors dedicated to GCOS 7. 


— there must be at least the same size of physical memory left for WINDOWS 
than the memory size allocated to GCOS 7. 


Static configuration is more simple on XTA models because bisystem feature is 
not available and only one system can take place. 


The Dynamic Reconfiguration of the CSS resources takes place when the system 
is running. 


When a V7000 IO process or thread aborts a processor check exception is reported 
to GCOS7, then this resource and all the down linked ones are dynamically set out 
of the configuration by GCOS 7 if no resident or system device is concerned. Just 
after, this IOP or PXU has to be set into the configuration through a GCOS 7 
operator command. 


The Reconfiguration of PSS components is described in 10.1.3.: 
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It is always performed when the system is running, 
It is performed through GCOS 7 commands, 


All what is described in section 10.1 applies, except LOS and dual LOS features 
that are never managed by DPS 7000/XTA modes. The physical channels 
management is done by WINDOWSTM. 


Dual access to disks and IO load balancing are available or not depending on 
disks subsystems connected and their associated features (ATF for FDA and 
Power Path for CDA7). Please refer to section 2 of this manual or related disk 
subsystem documentation. 
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A. Operator-System Dialog on a Console 


A main operator session may be logged in the SYS.LOGC system file (refer to 
Chapter 4: Main Operator Console Log). 


There are four types of dialog which can occur during a GCOS 7 session: 


e Messages from the system to the operator. 

e Operator commands to the system. 

¢ Questions by the system requiring an immediate reply. 
¢ Questions by the system which accept a deferred reply. 


Messages from the System to the Operator 


Informative messages may take one of two forms. 


1. Form 1 is preceded by a time stamp, followed by the object and the message 
itself, as shown in the two examples below: 


hh.mm dvnm OUT 
(meaning that the specified device is removed from the configuration) 


(BY SYSTEM) 


hh.mm ron STARTED jnm usernm jclass 
(meaning that the specified job has started execution) 


where: 


hh.mm 
dvnm 
ron 
jnm 
usernm 
jclass 
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is 
is 
is 
is 
is 
is 


the 
the 
the 
the 
the 
the 


time stamp in hours and minutes 
device name and number 

run occurrence number 

job name 

user name 

job class 
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Form 2 differs from the first in that it has a 2-character, 2-digit identifier 
instead of a time stamp, as shown below: 


DV24 dvnm UNKNOWN VOLUME 
(meaning that the system cannot recognize the volume mounted on the device 
indicated) 


CG05 ATT SUCCESSFUL 
(meaning that an ATTACH_CATALOG command has been successful). 


where the first two characters of the identifier relates to the message set (e.g., 
DV = devices, IL = initial load) and the second two digits represent the 
number of that message in the set. 


If operator action is required the message is preceded by an asterisk "*": 


* hh.mm dvnm MOUNT volnm FOR ron 
(meaning the job indicated needs the specified volume to be mounted on the 
device shown, which is free to be used). 


These messages are repeated until the operator takes the necessary action. To 
indicate a repeated message two asterisks (**) precede the message. 


If a message extends to more than one line, the following lines are indented 
but neither the time stamp nor the identifier are shown. For example, 


02/hh.mm ron.ssn 1lm-nm ABORTED [SEV sevnb] REPEAT? 
status RC = cccccccee --> siu, return code 


NOTE: 


This first three character positions on the log are reserved exclusively for the 
action indicator (*), repetition indicator (**) and deferred reply identifier (02/ in 
the above example). 


Operator Commands to the System 


GENERAL PROCEDURE (In line mode) 


1. 


Voges ee 


Press the ATT or BREAK or Insert key on the system console. This causes a 
flashing underscore character to appear. 


The message S: appears at the start of a new line. 
The flashing underscore is replaced by a flashing cursor. 
The message may now be keyed in. 


When the message is correctly formatted, press the EXECUTE or 
TRANSMIT key. 


If the VDU and the Console Serial Printer are both functioning as the console, the 
message appearing on the VDU screen is also printed on the serial printer. 
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Operator-System Dialog on a Console 


Example 


S: SOW PRO1 (meaning Start Output on Printer 01) 
(The underlined part is the command entered by the operator). 


ENTERING COMMANDS 
When typing in commands, note the following: 


e Some commands require several parameters; these parameters are separated by 
at least one space. 


e Ifacommand extends to more than one line, the first line should be terminated 
by a hyphen. The system outputs -: at the beginning of the next line, and the rest 
of the command can be typed in. 


e Several commands may be typed on the same line. 
e Onan IOF console, each command must be terminated by a semi-colon(;). 
ABNORMAL CASES 


There are several abnormal cases to be considered: 


e The typed command is incorrect but has not yet been confirmed. 
Press the ? (backspace) key repeatedly to delete the incorrect entry, then re-type 
the command. 


e The command does not exist. 
The system answers: 
OP02 cmdnm UNKNOWN COMMAND 
You should enter a legal command. 
e The command syntax is illegal. 
The system answers: 
OP03 cmdnm ILLEGAL SYNTAX 
You should re-type the command, with the correct syntax. 


e The system queues are full or the processor is not active. The command is not 
taken into account and the system answers one of the following: 


OPO07 cmdnm RETYPE THE COMMAND LATER 


OPO08 cmdnm COMMAND NOT CURRENTLY AVATLABLE 
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Questions Requiring an Immediate Reply 


This type of question is displayed when the system needs instructions and cannot 
continue until an answer has been provided. 


The syntax of the question is an asterisk, operation code, colon, question subject, 
and a question mark. 


On the line following, the system issues the prompt, I:. You must now type in the 
answer. 


For example: 


* SVO5 GCOS: FILE SALVAGING ? 
I: NO 
(the underlined part is the operator's reply). 


The question is repeated if the answer is not given within a certain time. No other 
message is given after the system has displayed I:, until the operator has typed in a 


reply. 


Questions Which May be Given a Deferred Reply 


This type of question may be answered at the operator's convenience by using the 
REPLY command. A reply identifier is given with the question which must be used 
in the operator's reply. 
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Example 


07/OU02 PRO2 OUTPUT X18:4 RESTART FROM ? 


S: REP 07 BEG 

If the answer is incorrect the question is re-issued but with another reply identifier. 
ABNORMAL CASES 

There are two abnormal cases: 


e the reply identifier does not correspond to the one given in the question, 
e the job which asked the question has terminated. 
In both cases the system answers: 


OPO01 INVALID REPLY IDENTIFIER OR ALREADY ANSWERED 


In the former case, the operator should retype with the correct reply identifier. 
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B.1 DUMPACT 


B. Calling System Utilities 


EJR DUMPACT LIB = SYS.HSLLIB VALUES = (efn, dvc, volnm, filestat, 
options, lmlib) 


where: 


efn 

dve 
volnm 
filestat 


options 


lmlib 
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: user file name 
: Gevice class name 
: volume name 


file system option 
[ { AP | ov } ] 
[ { OLD | v5 } ] 


[ DB ] 


: Gevice class name 


and volnm of LM library 


Defaul 
Defaul 
Defaul 
Defaul 
Defaul 
Defaul 


Defaul 


Defaul 


eT ct ct ct 


AP (Append mode) 
current record format 


Normal mode 
(No debug option) 


SYS .HLMLIB 
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Description of Options: 


AP User file opened in append mode 

OU User file opened in output mode 

OLD Record format of the V5 Release (the keyword OLD 
ensures compatibility) 

V5 Record format of the V5 Release 

DB Debug option. 

NoTE: 


Options are separated by a space, and enclosed by quote marks (e.g. 'OU VS '). 


[{AP}] [{OLD}] 
EJR DUMPACT LIB = SYS.HSLLIB VALUES = ([,OPTION = [{ }][{ }] [(DB]]); 
[{ou}] [{v5}] 


When the DB parameter is used, the Accounting Virtual Memory File is not erased. 
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Calling System Utilities 


B.2 PRLOG 
EJR PRLOG LIB = SYS.HSLLIB VALUES = ('prlog-options') 
Prints the contents of the SYS.ERLOG file. 
(The 'prlog-options' are decided by the Service Center) 
B.3 PRLOGC 
EJR PRLOGC SYS.HLMLIB [,OPTIONS = 'options'] 
where ‘options’ is: 
{ REPORT = { ALL | hexs } } 
{ } 
{ [ {LASTP}] [ 1 1} 
{ REPORT=ACTIVE [,FROM={BEG }][,TO= hh.mm}] [, LINES=nnn] [, SUMMARY=/string/] } 
{ [ {hh,mm}] [ ll 1} 
Where: 
ALL Print the entire contents of the file SYS.LOGC. 
hex8 Print console file concerning the specified CPU. The 
CPU concerned is identified by a string of eight 
hexadecimal characters. The characters are found in 
the footer of the SYSOUT banner. 
ACTIVE Print console lines concerning the CPU where 


H_PRLOGC is running. 
The following parameters may be used with the ACTIVE option: 


FROM = LASTP Indicates that printing has to be resumed where it was 
left off. If this has already been done, printing begins 
from the oldest message. (Default option) 


FROM = BEG Indicates that printing must start at the oldest available 
message. 


NOTE: The level LASTP is only kept up to date for 
these two options if they are used on their own. 


FROM = hh.mm Indicates that the listing must begin from the indicated 
hour, within the limits of the last 24 h. If it is 
unsuccessful, printing starts from the oldest message. 
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TO = hh.mm Printing stops at the dialog logged at the given time, 
hh.mm. If no dialog is found for that time, printing 
stops at the last dialog logged. 


LINES Gives the maximum number of lines to be printed. 
SUMMARY Only prints the lines containing the specified string. 
The string cannot contain a slash and cannot exceed 12 
characters. 
NOTES: 
1. The use of the last three options prevents the level LASTP from being 
updated. 
2. PRLOGC can also be invoked using the following Load Module in 
SYS.HLMLIB: 
STEP H PRLOGC,SYS.HLMLIB OPTIONS = 'REPORT = ACTIVE, FROM = '&1';'; 


B.4 TD (Tests and Diagnostics) 
EJR TD LIB = SYS.HSLLIB VALUES = (parameters) 


Refer to the Operator Reference Manual or the Operator's Guide for your system, 
and to the OLTD Operator Guide for a description of these parameters. 
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B.5 DP_SAVE (Saving GCOS 7 Anomaly Files) 


B.5.1 Introduction 
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The main purpose of EXECUTE_DP_SAVE is to generate Software Technical 
Action Request (STAR) elements. These are automatically saved on tape when an 
anomaly has occurred on the system. 


The elements saved depend on the anomaly type, which can be: 
e asystem crash 
e a NETwork processor (NET) anomaly 


e an OPEN 7 crash 


e ajob (except telecom or OPEN 7) abort that creates a binary dump in the 
SYS.SPDUMP file 


e any other anomaly without a dump. 


System Crash 


The following assumes: a crash occurred, the system is now running under normal 
conditions, and that a dump was saved in the efn (default SYS.SYSDUMP) file by 
the ISL dump commands: 


* IL03 DUMP ? 0, [efn:] media, DEF 
* TLO3 DUMP ? EXEC,DPS STD 
* IL03 DUMP ? END 


See also Section 3.4.3.5 DUMP command. 


NET Anomaly 


The following assumes that an anomaly occurred on one or more NETwork servers 
(Datanet, CNP7), or Local Controllers (TNS, OCS), and that one or several dumps 
(depending on NET type) are written to the SYS.DSADUMP library by either of 
these commands: 


S: STSVR TYPE=FECM RSYS=<FEP name> ACTION=DUMP 
(if the Network Server is a Datanet or CNP7) 


S: STSVR TYPE=OCS NAME=<OCS server name> ACTION=DUMP 
(if the Local Controller is an OCS) 
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OPEN 7 Crash 
Note that DP_SAVE is only supported from OPEN 7 V2.0.4. 


When an OPEN 7 crash occurs, the following message is sent to the OPEN 7 
submitter: 


From Submitter-name <Xnnnn>: *** CRASH OF THE OPEN7 <OPEN7-name> 


The RON "Xnnnn" is the RON of the job "OPEN7". The "OPEN7-name" 
corresponds to the OPEN7 directory name. 


OPEN 7 writes the JORs of the OPEN7, OPEN7P, and OPEN7R jobs in the 
OPEN7 DUMP library. 


Several OPEN7P and OPEN7R jobs are associated with one job "OPEN7". 


Job Abort 


After a job abort (except telecom or OPEN 7) that creates a binary dump in the 
SYS.SPDUMFP file, the following message is sent to the operator console and the 
JOR: 


DP03 ron_dsn_ dpindex PGID=jjjj 1lm-name DUMP CREATED 
where: 


e ron is the Run Occurrence Number of the job. 


e dsn is the Dynamic Step Number. It starts at | and increments at each executed 
step. (This enables two executions of the same step to be distinguishable). 


e dpindex is the Dump Index. It starts at 1 at the beginning of the step, and 
increments each time a dump is taken. 


Example 


DPO3 X1493 4 1 PGID=16 H LIBMAINT DUMP CREATED 


This refers to the first dump of the fourth step of job X1493. 


An Anomaly with no Dump 


This results either in system traces or a write to the system error log file 
(SYS.ERLOG). 
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B.5.2 Processing 


Use the primary screen of the EXECUTE_DP_SAVE directive to specify the type 
of anomaly, plus information about the system and output media. A secondary 
screen displays specific parameters for each anomaly. 


After all of the required parameters have been specified, JOB DP SAVE is 
launched to save the elements on the output media. At each main step of the job 
execution, messages are sent. 


The processing is normally terminated when JOB_DP_SAVE is completed. If it 
aborts, a message is sent to the submitter. The output of the job must be scanned 
and after correction (if any) the command EXECUTE _DP_ SAVE can be re- 
launched. 


B.5.3 Syntax of the EXECUTE_DP_SAVE Directive 


{ EXECUTE DP SAVE } 
{ DP SAVE } 
{ DPSV } 


B.5.3.1 Parameters Displayed on the Primary Screen 


{SYSTEM_CRASH } 
[{ } = bool] 
[ {CRASH } 


NET_ANOMALY 
NET 
{ TNS|FEPS|OCS|FECM|NO|0|1}] 
FEP_ ANOMALY 
FEP 


[{ 
{ 
{ 

[{ 

[{ 


a a an ee) 
Il 


[{OPEN7 CRASH } 
[{ = {0 | bool}] 


[{OPEN7 


{OTHER PROBLEM } 
{ = {0 | bool}] 


{OTHER 
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{USER_INFORMATION} 

{ } = {0 | bool}] 

{USER } 
[{SITE } = {#WSYS | name4}] 
[ {REPORT } = {YES | NO}] 

{OUTPUT_MD } 
[ {OUTMD } = (name6[,name6 [,name6 [,...]]])] 
{OUMD } 

{OUTPUT_DVvc } 

{OUTDVC } = {MT/T9/D6250 | char20}] 
{OUDVC } 

{ SYSCATMD } 

{ } = name6] 

{ SYCATMD } 

{SYSCATDVC } 

} = char20] 
{SYCATDVC } 
KEEP = {0 | bool }] 


B.5.3.2 Parameters Displayed on a Secondary Screen 


More parameters are displayed on a secondary screen. Which parameters are 
displayed depends on the type of anomaly. 


SYSTEM CRASH = 1 


INEFN = { SYSSYSDUMP | file44 }] 
INMD = name6 ] 
INDVC = char20 ] 
PRINT = { NO|MM} ] 
DPSZ = { 40 | dec4 } ] 
WKMD = name6 ] 
WKDVC = char20 ] 
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NET_ANOMALY = TNS 


{ LCT NAME } 
{ LCT } 


[ RON = Xnnnn ] 


NET_ANOMALY = FEPS 


NODE = ( name4, [ name4 ], [ name4 ], [ name4 ] ) 


[ RON = Xnnnn ] 


NET_ANOMALY = FECM 


{ LCT NAME } 


[ { } = EAnn ] 
{ LCT } 
{ RSYS NAME } 

ps4 } = name4 ] 
{ RSYS } 


NET_ANOMALY = OCS 
ocs = ( EAnn, [ EAnn ], [ EAnn ], [ EAnn ] ) 


RON = Xnnnn 


NET_ANOMALY = 1 (previous visibility TS 7458) 


[ NODE = name4 ] 
[ ocs = name4 ] 
[ RON = Xnnnn ] 


{ OPEN7 DIRECTORY 

{ } = { OPEN7 | char20 } 
{ OPEN7DIR 

[ RON = Xnnnn ] 


47 A2 53US B-9 


GCOS 7 System Operator's Guide 


OTHER_PROBLEM = 1 


[ RON = Xnnnn ] 
[ DUMP_ID = charl13 ] 
[ TRACE ONLY = { 0 | bool} ] 


B.5.3.3 Parameters Displayed on an additional Secondary Screen 


B.5.4 


In the case of USER_INFORMATION = 1, more parameters are displayed in an 
additional secondary screen. 


[ UEFN = file44 ] 
[ ULIB = 11b44 ] 
[ ULIBTYPE = { SL | LM | BIN | SM | CU }] 
[ USFN = (| “chars. } ] 
[ UMD = name6 ] 
[ UDVC = char20 ] 


Description of Parameters 


SYSTEM _ CRASH Indicates whether system crash anomaly or not. 
A dump must have been saved in the efn file (see 
INEFN parameter) at the ISL step. If no type of 
anomaly is selected by the submitter (e.g. S: 
EXECUTE_DP_SAVE;), GCL automatically selects 
SYSTEM_CRASH. 
No default value. 


NET_ANOMALY Indicates whether the incident occurred on Network 
frontals (DATANET, CNP7, or OCS). 
The old visibility TS 7458 is always accessible when 
NET=1, but it is more suitable to select, depending on 
the context of the anomaly, one of the new values: 
TNS, FEPS, FECM or OCS. 
In addition, these new options allow to save several 
dumps, depending on the type of frontal impacted. 
Default value: NO (equivalent value: 0) . 


OPEN7 CRASH Indicates whether the incident is an OPEN 7 crash. 
Default value: 0. 


OTHER PROBLEM Must be used when the anomaly is not a system crash, 
FEP anomaly or an OPEN 7 crash, and when a binary 
dump or only system traces are produced. 

Default value: 0. 
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SITE 


REPORT 


OUTPUT_MD 


OUTPUT_DVC 


SYSCATMD 


SYSCATDVC 


INEFN 


INMD 


INDVC 


PRINT 


DPSZ 
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Must be used when a private file or subfile has to be 
saved by DP_SAVE with the previous elements. 
Default value: 0. 


Gives the name of the site where the crash occurred 
(up to four characters). The name(s) of the tape(s) used 
by DP_SAVE are assigned at runtime, using the 
site-name as a prefix. 

Default value: #WSYS. 


If REPORT=YES the job execution listing is output. If 
an error is detected during DP_SAVE, the job 
execution listing is provided whether REPORT=YES 
or REPORT=NO. 

Default value: YES. 


Name of the output media (up to ten value). 

By default, if this parameter is not given, names are 
generated by the GCL EXECUTE_DP_SAVE with the 
parameter <SITE> and the DATE and TIME. 


Device class of the output media: tape (MT) or 
cartridge (CT). 
Default value: MT/T9/D6250. 


Media name of the volume where SYS.CATALOG 
was located at crash time. 


Device type of the SYSCATMD volume. 


External file-name of the input file containing the 
dump. 
Default value: SYS.SYSDUMP. 


Name of the media containing the input-file in the case 
of a non-cataloged file. 


Device-type of the media containing the input-file in 
the case of a non-cataloged file. 


PRINT=MM prints a summary. PRINT=NO means no 
print output. 
Default value: NO. 


Specifies the size (in cylinders) of a temporary file, the 
image of the SYS.SYSDUMP. The file is created by 
DP_SAVE and the summary report (see PRINT 
parameter) is written from it. 

Default value: 40. 
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WKMD 


WKDVC 


RON 


KEEP 


DUMP _ID 


TRACE ONLY 


OPEN7 DIRECTORY 


NODE 


When PRINT=MM is selected, the INEFN file must 
first be transformed into a DPAN (work) file. WKMD 
indicates the media where this work file is located. If 
no value is given, the work file is allocated to a 
resident disk. 

No default value. 


Device type of the media containing the temporary 
work file for printing. 
No default value. 


Run Occurrence Number of the job that aborted. 

In NET or OTHER PROBLEM context, this option 
saves all the binary dumps produced by the job each 
time it aborts. 

In OPEN 7 crash context, it is the ron of the job 
OPEN7. 

No default value. 


If set to 1, indicates in the OPEN7 CRASH context or 
in the OTHER_PROBLEM context that the JORs and 
LOG of OPEN7 or the binary dump have to be kept in 
the library at the end of the DP_SAVE execution. 
Default value: 0. 


Indicates the number of the binary dump produced by 
the abort of a job in OTHER_ PROBLEM context. This 
parameter is required only when the job created several 
identical binary dumps. 

Default value: <%RON> *. 


TRACE ONLY=! indicates that only system trace 
files have to be saved without any DUMP in 
OTHER_PROBLEM context. 

Default value: 0. 


Name of the OPEN 7 directory. 
Default value: OPEN7. 


When NET=1, indicates the name of a Datanet or 
CNP7 where the incident occurred (old TS 7458 
visibility). 

When NET=FEPS, indicates a list of up to 4 Datanet 
or CNP7 names where incidents occurr. 
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LCT_NAME When NET=TNS, indicates a list of up to 2 local 
controller names (LCT) where incidents occurr. 
When NET=FECM, indicates a local controller (LCT 
manageable by the local system). 


OCS When NET=1, indicates the name of an OCS 
controller where the incident occurrs (old TS 7458 
visibility). 
When NET=OCS, indicates a list of up to 4 OCS 
controller names where incidents occur. 


UEFN External file name of a user-defined file. 
No default value. 

ULIB Name of a user library containing the subfile(s) to 
save. 


No default value. 


ULIBTYPE User library type (see ULIB parameter). 
No default value. 


USFN User subfile(s) name to save (see ULIB parameter). 
Star convention is allowed. 
Default value: * (all subfiles). 


UMD Indicates the medium containing the user file or library 
in case of uncataloged objects. 
No default value. 


UDVC Device type of the media containing the user file or 
library, in case of uncataloged objects. 
No default value. 


The <user> parameters should be used to save a file or subfile(s) which may help 
to solve the problem, for example, a user program source subfile and / or generated 
listings, or a user application trace file (e.g. a VCAM user trace file). 


IMPORTANT: 
1. A file or subfile saved using the UEFN or USFN parameters must be 
identified in the STAR problem description, otherwise its meaning is 
unknown when it is restored from tape. 


2. Ifamismatch occurs during the selection of options ina DP_SAVE 
session, exit the EXECUTE _DP_SAVE directive, restart it, then enter the 
values again. 


3. When KEEP=1 is specified, it is the system administrator's responsibility 
to delete the elements, and avoid library overflows. 
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Constraints 


Only one of the parameters SYSTEM CRASH, NET_ANOMALY, 
OPEN7 CRASH, or OTHER_PROBLEM may be used. 


In an OTHER_PROBLEM context, when TRACE ONLY = 1, RON and 
DUMP_ID must not be specified. 


In the NET ANOMALY context: 


e with the old visibility (TS 7458 compatible), either NODE or OCS must be 
specified and they are mutually exclusive. 


e when NET=FECM, either LCT _NAME or RSYS_ NAME must be specified and 
they are mutually exclusive. 


e when NET=OCS, the RON parameter is mandatory. 


B.5.5 Elements Saved 


Table B-1 describes the parameters to use according to the anomaly context of 
SYSTEM CRASH, OPEN7_ CRASH or OTHER PROBLEM and the elements 
saved for each context. 


Table B-1. SYSTEM_CRASH, OPEN7 and OTHER_PROBLEM 
Anomaly Parameters and Elements Saved by DP_SAVE 


Anomaly and Context Specific Parameter(s) to Use Saved Files 
Parameter 
[SYSTEM CRASH=1] [INEFN=<file name>] System dump. 
OPEN 7 crash OPEN7_ DIRECTORY= JOR of OPEN7, OPEN7P 
OPEN7_ CRASH = 1 <dir name> and OPEN7R jobs in 
RON = Xnnnn OPEN7 DUMF file. 


LOG subfiles in OPEN 7 
DUMF file. 


System information files. 


Other anomaly with binary | RON = Xnnnn Binary dump(s). 

dump or System information files. 
OTHER PROBLEM=1 DUMP _ID= Xnnnn 1 j 

Other anomaly without TRACE ONLY=1 System information files. 
dump. 

OTHER PROBLEM=1 
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Table B-2 describes the parameters to use according to the NET ANOMALY 
contexts, and the elements saved for each context. 


Table B-2. NET_ANOMALY Parameters and Element Saved by 
DP_SAVE (1/2) 


Anomaly and Context Specific Parameter(s) to Use Saved Files 
Parameters 


FEPS (Datanet, CNP7) NODE = (<server-name>, FEPS dump (s) 
NET_ANOMALY = FEPS <server-name>, FEPS history files 
<server-name>, FEPS patches 
<server-name>) DSA logfiles 
FEPS trace files 
System information files 
with in option: RON=Xnnnn save SYS.SPDUMP binary dump. 


TNS (LCT) LCT_NAME = (<Ict-name>, TNS dump (s). 
NET ANOMALY = TNS <Ict-name>) TNS history files. 
TNS patches. 
DSA logfiles. 
TNS trace files 
System information files. 
with in option: RON=Xnnnn save SYS.SPDUMP binary dump. 


OCS (LCT) OCS = (<Ict-name>, FEP dump. 

NET ANOMALY = OCS <Ict-name>, FDDI dump. 
<Ict-name>, TNS patches 
<Ict-name>) OCS dump. 

FEP configuration file. 

DSA logfiles. 

OCS controller trace file 

OCS server trace files. 

System information files dump(s). 
RON=Xnnnn save JOR and SYS.SPDUMP binary 

dump. 

FECM (LCT) LCT_NAME = <lIct-name> LCT dump (s). 

NET ANOMALY = LCT history files. 

FECM LCT patches. 

DSA logfiles. 

System information files. 

FECM (Remote System) RSYS_ NAME = RSYS dump (s). 

NET_ANOMALY = <remote-system-name> | RSYS history files. 

FECM RSYS patches. 

DSA logfiles. 
System information files. 
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Table B-2. NET_ANOMALY Parameters and Element Saved by 
DP_SAVE (2/2) 


Anomaly and Context Specific Parameter(s) to Use Saved Files 
Parameters 


(Datanet, CNP7, Local NODE = <server-name> idem FEPS case 
Controller OCS, Local or or 
Controller TNS) NODE = <Ict-name> idem TNS case 
NET ANOMALY = 1 or or 

OCS = <Ict-name> idem OCS case 
(old visibility TS 7458) 


with in option: RON=Xnnnn save SYS.SPDUMP binary dump. 


The system information files saved by DP_SAVE are: 


e The list of all system patches and the contents of site patches. 


e Information about system hardware configuration as well as system firmware 
and software status. 


e Messages sent to/from the main console (copy of the SYS.LOGC file). 
e¢ Complete report on hardware and system errors (copy of the SYS.ERLOG file). 
e Events recorded by the standard system trace (copy of the SYS.SWLOG file). 


e Optional system trace backup files (the SYS.GSF.SWLOG_0 and 
SYS.GSF.SWLOG_1 files). 
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B.5.6 Examples 


B.5.6.1 Examples of Commands 
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All the system trace files are always saved. 


System Crash Context 


EXECUTE DP SAVE; {save the file SYS.SSYSDUMP on tape with the name 
generated by DP_SAVE} 


DP_SAVE SITE=BY12 OUTPUT _DVC=CT; 
{save the file SYS.SSYSDUMP on site BY12 on 
cartridge with the name generated by DP_SAVE} 


OPEN 7 Crash Context 


DP SAVE SITE=BY12 OPEN7 CRASH=1 OPEN7 DIRECTORY=OP7 RON=X1234; 
{save on tape the JOR and log of the OPEN 7 "OP7", 
RON X1234} 


DP_SAVE OPEN7 RON=X1234; 
{save on tape the JOR and log of the OPEN 7 
"OPEN7", RON X1234} 


NETwork Anomaly Context 


DP_SAVE SITE=BY12 NET=OCS OCS=(EA51, EA69, EA91), RON=X457; 
{save elements for the local OCS controllers EA51, 
EA69 and EA91; save binaries dumps X457_ *} 


DP_SAVE SITE=BY12 NET=FEPS NODE=(BY21, BO45, BL74, BY32); 
{save elements for the datanets BY21, BO45, BL74 
and BY32} 


DP_ SAVE SITE=BY12 NET=FEPS NODE=(BY21) RON=X56; 


{save elements for the datanets BY21; save binaries 
dumps X56_*} 


DP_SAVE SITE=BY12 NET=TNS LCT=(EA51, EA69) RON=X715; 
{save elements for the local TNS controllers EA51 and 
EA69 and binaries dumps X715_*} 
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DP SAVE SITE=BY12 NET=FECM RSYS=(BY21) ; 
{save elements for the remote system BY21} 


DP_SAVE SITE=BY12 NET=1 NODE=(BY21) ; 
{save elements for the datanets BY21, using the old 
TS7458 visibility} 


OTHER_PROBLEM Contexts 


DP_SAVE SITE=BY12 OTHER PROBLEM=1 RON=X354; 
{save all binary dumps for RON X354} 


All Contexts 


DP_SAVE SITE=BY12 OTHER RON=X1234 USER _INFORMATION=1 UBFN=MY.FILE; 
{save the elements linked to the incident plus the user 
file MY.FILE} 


DP_SAVE CRASH INEFN=SYS.SYSDUMP1 USER_INFORMATION=1 ULIB=MY.LIB 
ULIBTYPE=SL USFN=MY_SUBFILE *; 7 
{save the elements linked to the crash plus the user 
subfiles MY_SUBFILE_* in the source library 
MY.LIB} 


DP_SAVE OTHER DUMP ID=X_1234 1 2 SYSCATMD=DISK1 SYSCATDVC=MS/FSA; 
{save the elements of the incident that occurred on the 
non-running system set on the volume 
DISK1:MS/FSA} 
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B.5.6.2 Examples of Contexts 


Example 1: on a site called HCSI 


1. Asystem crash occurs. 

2. At ISL time the operator chooses the DUMP option. 
At the prompt * ILO3 DUMP? he answers: 
ILO3 DUMP? O,SYS.SYSDUMP, DEF 
ILO3 DUMP? EXEC,DPS_ STD 

3. Following GCOS 7 READY, he launches DP_SAVE with the directive: 
EXECUTE DP SAVE; 

4. DP SAVE gives a list of 10 tapes to be used, the names of which are prefixed 
by the site name, e.g.: 


HCSI1A, HCSI1B, HCSI1C, HCSI1D, HCSI1E, HCSI1F, HCSI20, 
HCSI21, HCSI22, HCSI23 


NOTE: 
DP_SAVE can prepare the name with the OUTPUT_MEDIA = <media-name> 
option, but the actual names of the tapes are assigned at this moment. Therefore 
it is not possible to prepare the tapes beforehand (VOLPREP). This avoids tape 
name conflicts at Bull Service Centers. 


5. The operator prepares the tape(s). To do this he may use a site-specific 
command (to be created before), e.g.: 


PREPARE TAPE VOL=<oldmd>:MT/T9 NEWVOL=HCSI1A:MT/T9/D6250) 
6. He waits for the end of the JOB DP_SAVE. 
7. Then the operator sends, to the Bull Service Center: 


— the DP_SAVE listings: the JOR, the summary printing (if value 
PRINT=MM is chosen), 
— the tapes. 
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Example 2: on the site called HCSI 


1. The FEPS server BYAB aborts and the following messages are sent to the 
operator console: 


DPO5 X2121 1 1 PGID=10 H_ FEPS DUMP CREATED 

TFO5 START LOG BY SERVER SVR_BYAB ON ABORT 

EFN: TRC _FEPS SVR_BYAB X2121 

TFO6 LOG TERMINATED BY SERVER SVR_BYAB ON ITS TERMINATION 
EFN: TRC _FEPS SVR_BYAB X2121 

CA21 SVR_BYAB COMPLETED 

16.54 X2121.1 ABORTED FEPS QTYC S SEV3 

RC=208504C5->EXCEP 5, PROCEXCP 


2. The operator launches DP_SAVE: 
EXECUTE DP SAVE NET ANOMALY=FEPS SITE=HCSI, NODE=BYAB, RON=X2121; 


3. He follows the steps 4 to 7 of Example 1 
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DP_PRINT (Printing a Dump on a Line Printer) 


Purpose 

The JCL command DP_PRINT is used to print information about a crash or a 
DPAN (Dump and trace analyzer) readable file. 

Syntax 


EJR DP_ PRINT LIB = SYS.HSLLIB VALUES = 


( INEFN = { SYS.SYSDUMP } ] 
{ efn ae 
[ INMD = { NIL }] {Inpve = { NIL } ] 
[ { media-name } ] [ { dvtyp } ] 
WKMD = { NIL } 1 [ wxpve = { NIL }] 
[ { work-media } ] [ { work-device } ] 
{Mm jl {No }] [ {no } ] 
PRINT = { FW } [ DPAN = { } ] [ REPORT = { }1) 
{ CRASH } [ { YES }] [ { YES } ] 
Parameters 
INEFN External file name of the file to be printed by DPAN. 
Default value: SYS.SYSDUMP. 
INMD Name of the media that contains the file to be printed. 
Default value: NIL (none). 
INDVC Device type of this media. 
Default value: NIL. 
WKMD When the file to be printed is SYS.SYSDUMP it must 
be first transformed into a DPAN type file (work file). 
This parameter indicates the media where this work 
file is located. 
WKDVC Device type of the work file media. 


Mandatory when WKMD is used. 
Default value: NIL. 
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PRINT Type of printing to be performed. 


PRINT=MM is the quickest global printing command. 
It gives a summary of all processes comprising: 


— The SYSTEM BASE 

— The STATUS of all processes 

— The RETURN CODES of the processes 

— The PCB and STACK FRAMES of the processors. 


PRINT=FW gives a summary of all processes 
comprising: 


— The TYPE 0 writable segments 
— VMM information. 


PRINT=CRASH prints an automatic summary 
concerning the crash reason. The summary given 
depends on the type of crash analyzed by DPAN. 


DPAN Indicates if the input file is of DPAN type or not. 
Default value: NO (for SYS.SYSDUMFP file). 


REPORT Is used to obtain the reporting of the job. 
Default value: NO. 


Example 


1. Acrash occurs. 


The dump is saved on the SYS.SYSDUMP file at ISL time. 


X 


3. To print the dump, enter: 


EJR DP_PRINT LIB=SYS.HSLLIB VALUES= (INMD=UTOPIE 
INDVC=MS/B10 PRINT=CRASH) 


4. Then send the listing to the Service Center or use it for a first analysis of the 


problem. 


NOTE: 
The patches are not printed. 


Resources required: 


Note that DP_SAVE with PRINT=MM and DP_PRINT use at least 50 cylinders 
(work file on WKMD). 


B-22 47 A2 53US 


Calling System Utilities 


B.7 SVLOGF (Saving TDS/UFAS/GAC Logfile) 


SVLOGF performs a continual saving of events produced by the TDS subsystem 
(including UFAS and GAC). 


The GCL command SVLOGF may be activated after assigning "MWINLIB BIN 
SYS.GSF.BINLIB". 


SVLOGF [SVLALC=0|1] [SVLMD=media_name] 
[SVLDVC=devclass] 


Description of Parameters 


SVLALC If 0, there is no pre-allocation of required sequential 
files for the storage of events (default); if 1, 
pre-allocation is required, two cataloged sequential 
files are pre-allocated: SYS.GSF.SVLOGF_0 and 
SYS.GSF.SVLOGF_1. 


SVLMD This is the media name of the volume where the 
pre-allocation is to be done (valid only if SVLALC=1). 


SVLDVC This is the device class of the volume for the 
pre-allocation. 


NOTE: 
The SVLOGF command without parameters assumes the two sequential files to 
already be present and dynamically starts a batch process for the saving of 
events. 
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B-24 


PRINTJOR (Print the JOR of a Job in Execution) 


Purpose 


The JCL command PRINTJOR is used to print a JOR of a JOB in execution. 


The user must specify the RON of the JOB and if necessary the PRTFILE where 
the information is to be stored, default is SYSOUT. 


Syntax 


EJR PRINTJOR LIB=SYSHSLLIB VALUES=(ron prtfile) 


Where: 
ron 


prtfile 


Description of Options 


RON 


PRTFILE 


RON number, mandatory. 
PRTFILE, default is SYSOUT. 


RON number of the job whose JOR is to be printed. 
The RON number can be specified as positional or 
keyword value of the form Xnnnn. Mandatory. 


The report file. When omitted, the report is printed in 
the SYSOUT (default value). The user can specify 
another PRTFILE, which must be in the form: 


- for cataloged library: 
LIB=mylib MB=mysubfile 
LIB=mylib SUBFILE=mysubfile 


- for uncataloged library: 
LIB=mylib MB=mysubfile MD=md 
DVC=dvc 
LIB=mylib SUBFILE=mysubfile MD=md 
DVC=dvc 


MB or SUBFILE can be used as keyword for 
specifying subfile. 
See examples of use below. 
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CAUTION: 
Due to the JOR mechanism which is based on a VMF file, only the VMF blocks 
written in backing store can be printed. The current block which contains the 
latest records is still in memory and cannot be printed. For a job with outputs, 
the JOR remains accessible by PRINTJOR until the message OUTPUT 
COMPLETED is issued. This is true even if the JOR has been cancelled. 


Constraints 
The RON parameter is mandatory. 
If SUBFILE, or MD, or DVC, is specified, LIB must be specified. 


Only a MAIN operator or SYSADMIN user can access all JORs. Other users can 
access only the jobs they have submitted or of which they are users. 


Error Messages 
The following error messages are sent to the submitter console and in the JOR. 


In case of JOR or PRTFILE access failed, the erroneous return code is printed in 
the JOR after the error message. 


PRINTJOR : ERRONEOUS OR UNKNOWN RON: ron 
PRINTJOR : PRTFILE ACCESS ERROR: OPEN FAILED 
PRINTJOR : PRTFILE ACCESS ERROR: WRITE FAILED 
PRINTJOR : JOR ACCESS ERROR: OPEN FAILED 


PRINTJOR : JOR ACCESS ERROR: READ FAILED 


PRINTJOR : ILLEGAL ACCESS TO JOR 
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Examples 


EJR PRINTJOR LIB=SYS.HSLLIB VL=X123; 
{result in the SYSOUT.} 


EJR PRINTJOR LIB=SYS.HSLLIB VL=(RON=X123) ; 
{result in the SYSOUT.} 


EJR PRINTJOR LIB=SYS.HSLLIB VL=(X123 LIB=MYLIB SUBFILE=MYSUBFILE) ; 
or 


EJR PRINTJOR LIB=SYS.HSLLIB VL=(X123 LIB=MYLIB MB=MYSUBFILE) ; 
{result in the subfile MYSUBFILE of the cataloged 
library MYLIB.} 


EJR PRINTJOR LIB=SYS.HSLLIB VL=(X123 LIB=MYLIB SUBFILE=MYSUBFILE 
MD=BFU033 DVC=MS/B10) ; 


or 


EJR PRINTJOR LIB=SYS.HSLLIB VL=(X123 LIB=MYLIB MB=MYSUBFILE 
MD=BFU033 DVC=MS/B10) ; 
{result in the subfile MYSUBFILE of the uncataloged 
library MYLIB.} 


B.9 V7000 Information Collector 


DPS 7000/XTA series include a new maintenance tool to gather all information 
located on the Windows™ side. 

This tool is only accessible by Bull services. It is a V7000 utility and it uses a 
specific graphical interface to enter commands. 


The operator can select the type of problem he wants to document, and the V7000 
information collector builds a compacted file on a 4 mm cassette. 


This media has to be sent to Bull center for analysis. 
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C. Index of Commands by "Object" 


CATALOG 


ATTACH (ATT) 


CLC (Cartridge Tape Library Client) 


DISPLAY (DCLC) 
EXECUTE (EXCLS) 
MODIFY (MDCLC) 
START (SCLC) 
TERMINATE (TCLC) 


CLX (Cartridge Tape Library Unix) 


CONFIGURATION 


COMPLEX MGMT 


CONSOLE LOG 


DEVICE 
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GET (GTCLXF) 

EXECUTE (VOLRPT) 
DISPLAY (DCLX, DSSI) 
MODIFY (MDCLX) 

START (SCLX, SSSI) 
TERMINATE (TCLX, TSSI) 


DISPLAY (DC) 
MODIFY (MDC) 


DETACH (DTSRV) 
DISPLAY (DCX) 

(DMB) 

(DSRV) 

START (SCMSR) 

(SMB) 

(SSRV) 
TAKEOVER (TKMB) 
TERMINATE (TMB) 

(TSRV) 


DISPLAY (DCLOG) 
START (SCLOG) 
TERMINATE (TCLOG) 


START (SDV) 
TEST (TSTDV) 
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DEVICE TRACE DISPLAY (DDVTR) 
MODIFY (MDDVTR) 
START (SDVTR) 
TERMINATE (TDVTR) 


DIMENSION CONNECT (CNDIM) 
CREATE (CRDIM) 
DELETE (DLDIM) 
DISCONNECT (DISDIM) 
DISPLAY (DDIM) 
MODIFY (MDDIM) 


DIRECTIVE EXECUTE (EXDIR) 


DJP (Distributed Job Processing) 
DISPLAY (DDJP) 
MODIFY (MDDJP) 


DPRINT (DPR) 


ERROR LOG DISPLAY (DERLOG) 
MODIFY (MDERLOG) 
SEND (SNDERLOG) 
START (SERLOG) 
TERMINATE (TERLOG) 


FILE DISPLAY _ASSIGNED_FILES (DASGF) 


FILE TRANSFER REQUEST FILTER 
ENTER (EFTR) 
CREATE (CRFLT) 
DELETE (DLFLT) 
LIST (LSFLT) 
MODIFY (MDFLT) 


FILTER SET CREATE (CRFLTST) 


FUNCTION CONNECT_FUNCTION (CNFUNC) 
DISCONNECT FUNCTION (DISFUNC) 
DISPLAY FUNCTION (DFUNC) 


GCL CACHE DISPLAY (DGC) 
HOLD (HGC) 
RELEASE (RGC) 

HARDCOPY START (SHC) 
TERMINATE (THC) 
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HARDWARE CONFIGURATION 


INPUT READER 


10 CACHE 


IOF 


JOB 


JOB REQUEST 
LIBTRANS REQUEST 
LOAD 


MAIL 
MIRLOG FILE 


MIRROR_MODE 


MIRROR_VOLUME 


MIRROR_ SHARED 


OPERATING MODE 
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DISPLAY (DHW) 
MODIFY (MDHW) 


MODIFY (MDIR) 
START (SIR) 
TERMINATE (TIR) 


DISPLAY (DIOC) 
START (SIOC) 
TERMINATE (TIOC) 


DISPLAY (DIOF) 
MODIFY (MDIOF) 


CANCEL (CJ) 
DISPLAY (DJ) 
FORCE (FJ) 
HOLD (HJ) 
MODIFY (MDJ) 
RELEASE (RJ) 


ENTER (EJR) 
ENTER (ELTR) 


CONNECT (CNLD) 
DISCONNECT (DISLD) 
DISPLAY (DLD) 
MODIFY (MDLD) 
START (SLD) 
TERMINATE (TLD) 


DEASSIGN (DASGMIR) 
UNLOCK (UNLMIRF) 


DISPLAY (DMIR) 
MODIFY (MDMIR) 


UNPAIR (UNPMIR) 
UNLOCK (UNLMIR) 


RESYNC (RSCMIR) 


MOT (Message Of Today) DISPLAY (DMOT) 


MODIFY (MDMOT) 
MODIFY (MDOM) 
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OUTPUT 


OUTPUT WRITER 


POWER TIMER 


REPLY (REP) 
REQUEST 


RESTART OPTIONS 


RMS 


SAVE SERVER 


SEND 

STATION 
SUBMITTER 
SYSTEM 
SYSTEM TRACE 


CANCEL (CO) 
DISPLAY (DO) 
FORCE (FO) 
HOLD (HO) 
MODIFY (MDO) 
RELEASE (RO) 


START (SOW) 
TERMINATE (TOW) 


DISPLAY (DPWR) (DPWRTM) 

MODIFY (MDPWR) (MDPWRTM) (TPW) 
START (SPWRTM) 

TERMINATE (TPWRTM) 


CANCEL (CR) 
DISPLAY (DR) 


DISPLAY (DRSO) 
MODIFY (MDRSO) 


DISPLAY (DRMS) 
START (SRMS) 
TERMINATE (TRMS) 


DISPLAY (DDYNSVR) 
START (SDYNSVR) 
TERMINATE (TDYNSVR) 


MODIFY (MDST) 
DISPLAY (DS) 
TERMINATE (TSYS) 


DISPLAY (DSYSTR) 
INITIALIZE (ISYSTR) 
MODIFY (MDSYSTR) 
START (SSYSTR) 
TERMINATE (TSYSTR) 
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TERMINAL OUTPUT 


TERMINAL WRITER 


TIME 


USER REQUEST 


VOLUME 


Working Environment 


XL_CLASS 


Index of Commands by "Object" 


CANCEL (CTO) 
DISPLAY (DTO) 
HOLD (HTO) 
MODIFY (MDTO) 
RELEASE (RTO) 
START (STO) 
TERMINATE (TTO) 


DISPLAY (DTW) 
MODIFY (MDTW) 
START (STW) 
TERMINATE (TTW) 


DISPLAY (DTM) 
MODIFY (MDTIME) 


CANCEL (CUR) 
DISPLAY (DUR) 
FORCE (FUR) 
HOLD (HUR) 
MODIFY (MDUR) 
RELEASE (RUR) 


MODIFY (MDV) 
NAME (NV) 


MWENVT 


DISPLAY (DXLC) 
MODIFY (MDXLC) 
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D. The SYS.URCINIT Printer Control File 


D.1 Introduction 


Printers can be operated under the supervision of a Unit Record Controller, which 
is a Microprogrammed unit capable of simultaneously controlling several such 
devices connected to the same central processor(s). 


The Unit Record Controller can be initialized from a set of parameters contained in 
a system file called SYS.URCINIT. The SYS.URCINIT file can be accessed and 
modified by means of a Unit Record Initialization program called URINIT. The 
URINIT utility can be used, for example, to insert into SYS.URCINIT a new 
character set and new form control information corresponding to a new print belt. 


Certain standard information is supplied by BULL S.A. for insertion into 
SYS.URCINIT. For instance, in the case of a printer, the following information is 
supplied at delivery: 


e the character set(s) corresponding to the standard print belt image. 

e physical format information for standard paper forms: page length, margin 
width, etc. 

e channel positions to be used for vertical format control. 

e a printing test routine. 


The URINIT utility program can be used for subsequent expansion, modification, 
deletion, or printing of the information contained in SYS.URCINIT. 


In actual use, JCL is used to define the format required for the particular 
application and the unit record drivers then access the appropriate information for 
use by the unit record devices during their input/output operations. 
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D.2 


D.2.1 


General Programming Considerations 


This section provides general programming information, with emphasis on the 
SYS.URCINIT file and the URINIT commands. 


The SYS.URCINIT File 


Js) 


Printers often serve as interfaces between the user and the system: they print out 
data for human inspection. However, the very nature of this interface means that 
the devices cannot be entirely automatic; they require a certain amount of user 
attention. 


In order to reduce this requirement to a minimum, while still ensuring all the 
advantages inherent in the unit record principle, BULL has developed user tools 
such as the SYS.URCINIT file and the URINIT utility program. 


The SYS.URCINIT file allows you to store all the parameters which you will most 
commonly require for your printer applications. Rather than defining the same 
requirements over and over again, you can simply reference the appropriate 
parameters recorded in SYS.URCINIT. The URINIT utility program is designed to 
enable you to use your SYS.URCINIT file most effectively; with it you can insert, 
remove, or print out data contained in the file, or you can redefine the inter- 
relations of certain types of data with other data. 


The SYS.URCINIT file is delivered in two forms: a minimum SYS.URCINIT file 
containing standard parameters, and a source subfile (called UREXT, a member of 
the SYS.HSLLIB file) which contains generation commands for all the standard 
parameters for all the devices. You will usually wish to record SYS.URCINIT on 
your system disk, in the form and containing the information best suited to your 
site. 


The space allocated to the SYS.URCINIT file is two disk cylinders. The delivered 
content of the file constitutes 10%, the remaining space is left available to the user. 
SYS.URCINIT is a queued linked file with relative addresses; it can be transferred 
by the FILSAVE and FILREST utilities (which are described in the Data 
Management Utilities manual). 


IMPORTANT: 
It is essential to retain a copy of the source each time you modify the 
SYS.URCINIT file. Without this copy you will not be able to rebuild the file if 
a problem occurs. The items included in this file are totally different from one 
site to another and the source UREXT only enables you to rebuild the minimum 
required for creation of standard states. 
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D.2.2 The URINIT Utility 


D.2.2.1 The URINIT Statement. 


The URINIT utility program is the basic tool used in updating and printing out the 
contents of the SYS.URCINIT file. The URINIT statement has the following form: 


URINIT COMFILE = (sequential-input-file-description) 
[PRTFILE = (print-file-description) ]; 


Parameter Description 


COMFILE Describes a sequential input file containing the 
URINIT commands described below; the commands 
can be read from diskette or from a source library 
member. See the JCL Reference Manual for the syntax 
of a sequential file. 


PARTFILE Describes the assignment to URINIT of a permanent 
file to be accessed through the SYSOUT access 
method. 


D.2.2.2 JCL Card Arrangement 


Updating the SYS.URCINIT file is a single-step job requiring the following JCL 
statements: 


URINIT COMFILE = *URC-TAB; 
SINPUT URC-TAB; 


(commands and parameters) 


SENDINPUT ; 


For detailed information on JCL statements, see the JCL Reference Manual. 
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D.2.2.3. URINIT Commands 


A URINIT command begins with an Order (one of the 7 functions described 
below) and ends with a semicolon (;). Between these two points are entered 
specific parameters according to the type of item to which the command relates. 
The parameters themselves are described in later sections of this document devoted 
to the individual devices. The command format and command sequence are both 
free. No continuation character is required and all blanks are deleted. 


URINIT ORDERS 


URINIT recognizes the following orders: 


MOVE Add a new item to the file 

DELETE Delete an item from the file 

RENAME Rename an item to the file 

LIST Print out the list of item names 

PRINT Print out the contents of all selected items 
LINK Link item together 

UNLINK Cancel links between items 

URINIT ITEM TYPES 


The orders listed above may be applied to the item types in the SYS.URCINIT file. 


There is a specific keyword for each item type. This keyword is 4 characters long; 
the 3 last letters define the type of device attributed to this item. 


There are 2 item types which differ from the rest: 


EPRU- IPRU 
Which is because their contents are made up of the names of other item types. 


Certain item types are interleaved by the system of links shown in Figure D-1. It is 
not necessary to have these links. It is advisable to define EPRU and IPRU item 
types instead of linking. 


In the following command formats, the ‘‘item-type™’ is one of the type keywords 
given in the first column of Table D-1. 
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MOVE COMMAND 


The MOVE command is used to enter a new item in the file or to modify an item 
that already exists, it has the following form: 


MOVE name [REPLACE] item-type = (parameters) [NCHECK] ; 


If the item already exists in the file, the REPLACE option must be used to modify 
the existing item and all the parameters must be given. 


If used for a PPRU item, REPLACE must be specified immediately following the 
name and before PPRU 


Example 
To define a special form, named BLUE, for the printer: 


MOVE BLUE FPRU = (parameters) ; 


Table D-1. URINIT Items 


KEYWORD “LN GTH RECORD 
BPRU BELT PRINTER 
KPRU ; PRINTER INIT PRINTER 
IPRU 2 INDEX TABLE PRINTER 
FPRU 4 FORM PRINTER 

4 


EPRU EDITING TABLE PRINTER 
CDDU 8 CHARACTER SET | DISKETTE 
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KPRU ~! BPRU q— 
7 max 
BPRU q— 
> 
FPRU P vPRU 
se PPRU 
er ~ optional 


—> mandatory 


Figure D-1. ‘Item Links 
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DELETE COMMAND 


The DELETE command is used to remove an item already existing in the file. This 
command has the following format: 


DELETE name item-type; 


Example 


to delete form BLUE from the printer: 


DELETE BLUE FPRU; 


RENAME COMMAND 


The RENAME command is used to update the corresponding record in the 
directory by changing its name. It has the following form: 


RENAME name NEW = name item-type; 


Example 


The user has a form called BLUE which he wishes to rename RED: 


RENAME BLUE NEW = RED FPRU; 


LINK COMMAND 


NOTE: 
It is recommended that you use the Index Table IPRU to KPRU/BPRU) instead 
of the LINK command. 


The LINK command is used along with character set and index table to define 
relationships among items. The items must already exist in the file before LINK 
can be used. This command has the following form: 


LINK {[KPRU = name BPRU = ( name [, name]...)]} 
{[BPRU = ( name, name [, name]...)] } 
NOTES: 


1. At least one of the optional parameters must be entered. 
2. The belts will be linked in the order specified. 
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Example 
to link print belt E502 to character set S2: 


LINK KPRU = S2 BPRU = E502; 


UNLINK COMMAND 


The UNLINK command is used to cancel relationships among items. It has the 
following form: 


LINK {[KPRU = name BPRU = ( name [, name]...)]} 
{[BPRU = ( name, name [, name]...)] } 
NOTES: 


1. At least one of the optional parameters must be entered. 


2. The belts must have been linked in the order specified. 


Example 


to cancel the link between print belt E502 and character set S2: 


UNLINK KPRU = S2 BPRU = E502; 


LIST COMMAND 


The LIST command causes each item in the catalog to be printed out. The 
command has the form: 


LIST [*]; 
The printed listing has the format: 

TYPE : Unit Record name-type 
*TTEM-MANE = XXXXXXXX 

LINK-NAME = XXXXXXXX TYPE = XXXX 


*TTEM-MANE = XXXXXXXX 
LINK-NAME = XXXXXXXX TYPE = XXXX 


TYPE : Unit Record name-type 
*TTEM-MANE = XXXXXXXX 
LINK-NAME = XXXXXXXX TYPE = XXXX 


D-8 47 A2 53US 


The SYS.URCINIT Printer Control File 


PRINT COMMAND 


The PRINT command causes one or more items in the file to be printed. It has the 
format: 


PRINT 
{ PRU } 
{ } 
{ { name } } 
{ { } item type } 
mae OS } 


That is, an asterisk followed by PRU will cause a printout of all items in the file 
related to printers. Or, alternatively, a given item having a specific name can be 
printed; or, if an asterisk is first entered, all KPRU items can be printed. 


The printout has the format: 


ITEM-NAME = XXXXXXXK TYPE = XXxXX 

LINK-NAME = XXXXXXXK TYPE = XXxXxX 

DATA 

KKKK 

KEYWORD = XXXXXXXX depending upon the item type 


KEYWORD = 


D.2.2.4 Command Restrictions 


The following notes and restrictions should be kept in mind when using the 
URINIT commands. 


MOVE 
e The item name must not already exist (except for the case of the REPLACE 
option) 


e For the Index Table (IPRU) and editing table (EPRU) the name specified as 
parameters must exist. 


e There is no name independence between the index table (IPRU) and character 
set (KPRU) or between the editing table and the form (FPRU); 
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DELETE 


e The item name must exist, otherwise a warning will be sent. 

e If other items are linked to the delete item, the links will be destroyed. 
e Ifthe item is a linked belt, the other items will be relinked. 

e Character set I1 and form 0000 must not be deleted. 


e Ifthe item is a translation table (KRPU) or a belt (BPRU) the contents of the 
index table which refer to it are modified (deletion of the name). After several 
deletions of BPRU when no more BPRUs exist in the index table it is deleted. 


e Ifthe item is a printer (PRU) the contents of the editing table are modified. 


e Ifthe item is a form, the editing tables are also deleted. 


RENAME 


e The old item name must already exist. 

e The new item name must not already exist. 

e Ifthe other items are linked to the item, the links are updated. 
e Character set I1 and form 0000 must not be renamed. 


e Ifthe item is a translation table or a belt, the contents of the index tables, which 
refer to it, are modified. 


LINK 


e All the items to be linked must already exist. 
e These items must not already be linked (except for the last). 


UNLINK 


e All the items to be unlinked must already exist and must be linked as described 
in the LINK command. 


e Ifthe last belt specified in the UNLINK command has a link, then the first belt 
so specified (or its character set) will be linked to that belt which was previously 
linked to the last one. 


e Character set I1 must always have a belt linked to it. 
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D.2.3 Parameter Overriding 


Many of the parameters originally specified (or assigned by default) for use by the 
unit record devices are subject to later modification by the user, especially by 
means of the JCL statement DEFINE. The specific parameters and overriding 
methods are discussed under the individual descriptions of each device type, in the 
following sections of this documents. See the JCL User Guide or the IOF Terminal 
User's Reference Manual for further information. 


D.2.4 Protected Character Strings 


Certain of the tables and parameters used by URINIT are created in the form of a 
character string which must be protected; that is, it must be enclosed between 
single quote characters ('). 


For more information on protected character strings, see the JCL User Guide. 


D.2.5 Direct Use of *Devices 


For most applications, the recommended method for using the unit record devices 
is the indirect mode, in which the program performs a spooling function via the 
system files SYS.IN and SYS.OUT. See the JCL User Guide. The printer, can also 
be accessed directly by specifically assigning to the device the internal-file-name 
defined in the program. 


D.2.6 Related Information 


For general information on programming and execution techniques, see the 
COBOL User Guide and the JCL User Guide or the IOF Terminal User's Reference 
Manual. For information on return codes and error messages, see the Messages and 
Return Codes Directory. 


For further information on data formats (including SARF and SSF), see especially 
the Library Maintenance Reference Manual and the COBOL User Guide. 
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D.3 Line Printer 


This section covers the parameters which can be used in URINIT to describe the 
character set (KPRU), belt arrangement (BPRU), print form (FPRU), vertical 
format control facility (VPRU), index table (IPRU), and editing table (EPRU). 


D.3.1 Device Naming and Allocation 


In many applications it is irrelevant which physical printer handles the output; if an 
installation contains several printers, the output may be routed to any one of them. 
However, if you so require you can select a specific printer model (not a 
recommended technique) or a printer having certain specific characteristics, by 
making use of the DEVCLASS parameter in any of the JCL statements SYSOUT, 
WRITER, or OUTVAL. (if the printer is being used directly, the ASSIGN 
statement is used for this purpose). 
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The characteristics which can be specified are summarized in the following Table. 


Table D-2. Printer Characteristics 


GENERIC | DEVICE PRINT Number of HORIZ. | VERTICAL FORM 
NAME MECH. HAMMERS PRINT PRINT HEIGHT 
or DENSITY | DENSITY 
Number of 
Columns Char. inches inches 
per 
inch i 
PR90 See note (2) 132 
See note ( See note (3) 


See note (2) 
See note (3) 
See note (2) 


PRUG007 


See note (1) | See note (1) 


NOTES: 


1. Dot matrix printer. 
2. "Software" belt. 


3. 132 in standard configuration but can be set to up to 160 on the printer 
panel. 


4. 11 in standard configuration but can be set to up to 24 on the printer panel. 


5. 136 in standard configuration but can be set to up to 272. 
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D.3.2 Printer Attributes 


Table D-3. Printer Attributes 


Device Type Speed Attribute Hammer Attribute Model Attribute 
or Number of Columns 


Fast 
Imperative 
Any 
speed hammers 
are 
needed 
Slow PR90 
Imperative 
PR701/ 
801/901 


SPEED ATTRIBUTE 


FI: Fast Imperative - You request the fastest printer. 


NOTE: 
If you specify FI, the request will be queued for that type of printer if the printer 
is not available. 


HAMMER ATTRIBUTE 


H <n> n may have any value from | to 160. Device Management will allocate a 
printer with at least as many hammers as specified. 


NOTE: 
"H112" will always be interpreted as a model attribute, not as a hammer 
attribute. In practice this is not restrictive, since less than 120 hammers will 
rarely be specified. 
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This facility is provided to make it possible to adjust the printer line length to the 
printed line length as specified in the program, so as to avoid line folding or similar 
complications. For instance, assume that the program contains printed lines of up to 
129 characters in length, and the installation is equipped with two printers: printer 
PRO1 has 160 hammers and printer PRO2 has 120 hammers. You can then specify: 


DEVCLASS = PR/H129 
to ensure that this output will be directed to printer PRO1. 
Two additional points should be noted in this respect: 


1. Inthe above example, if the program should happen to contain a printed line 
of, say, 135 characters, the line will be folded at character 130 despite the fact 
that the printer has 160 hammers. In other words, the H attribute really 
specifies print columns rather than hammers. 


2. Ifthe MARGIN option is used (see Form Definition below), the number of 
columns reserved for the margin must be taken into account in specifying the 
value of H. 


MODEL ATTRIBUTE 


You are strongly advised not to specify the printer model. The other attributes are 
retained here only in the interest of compatibility with previous GCOS releases. 


ATTRIBUTE PRIORITIES 


Attribute definitions are processed in the following order of priority, from high to 
low: 


1. Model. 
2. Number of hammers. 
3. Printing speed. 


Examples 


DEVCLASS: PR/H120 
A printer having 120 or more hammers will be allocated. 


DEVCLASS: PR/FI/H129 
The fastest printer is allocated provided that it has at least 129 hammers. If the 
hammer number is insufficient, the printer speed is not taken into account. 


DEVCLASS = PR 
Any printer will be allocated. 
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D.3.3 Printing Procedures 


You have a choice between the following output techniques. 


e Direct use of the printer. The output is printed at the same time as it is created by 
the user program. 


e Use of an intermediate file before printing (spooling technique). The output 
created by the user program is stored in a temporary system subfile (known as a 
standard SYSOUT subfile) or in a permanent user file (referred to as a 
permanent SYSOUT file). The actual printing is performed by a system element 
called the Output Writer, and may take place long after the output was created. 


The spooling technique is generally preferable, since it makes more efficient use of 
processing time and printer capabilities. For detailed information on SYSOUT files 
and the Output Writer, see the JCL User Guide. 


The user program is independent of the output method used; the output method is 
selected in the JCL that initiates the program. 


The following example illustrates these different techniques. 


Assume that we have a user program written in COBOL, containing 


SELECT OUT 
ASSIGN TO OUTFILE — SYSOUT 


FD OUT 
RECORD CONTAINS 129 CHAR 


For each possible output method selected, the JCL is given below. 


D-16 47 A2 53US 


The SYS.URCINIT Printer Control File 


D.3.3.1 Direct Use of the Printer 


S JOB...; 

STEP PROGA, ...; 

ASSIGN OUTFILE, DEVCLASS = PR/H129, MEDIA = 120001; 
ENDSTEP ; 

SENDJOB ; 


REMARKS: 


1. Aprinter with at least 129 hammers will be assigned to the job for the 
duration of the step. 


2. Index table (or character set) I2 and editing table (or form) 0001 will be 
used in printing this output. (Index tables/character sets and editing 
tables/printing forms are discussed later in this section.) 


D.3.3.2 Use of a Standard SYSOUT Subfile 
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SJOB...; 

STEP PROGA, ...; 

SYSOUT OUTFILE, DEVCLASS = PRO, MEDIA = 120001; 
ENDSTEP ; 


REMARKS: 


1. NoASSIGN statement is required because a standard SYSOUT subfile is 
used. 


2. The output data will be deleted from a SYSOUT file after it has been 
printed by Output Writer. 


3. The SYSOUT statement indicates that the index table and editing table to 
be used are different from the standard ones. If the Index table set and 
editing table were standard (110000 in most installations) then the 
SYSOUT statement could be omitted. 


The MEDIA parameter is defined by the SYSOUT, ASSIGN and WRITER JCL 
statements. For the printer MEDIA is a six figure character value which specifies 
the print belt, character set and paper identification; default value is 110000. 
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To change the define parameters within the step enclosure, SYSOUT is used, 
whereas WRITER is used outside the step enclosure. DEFINE does not use 
MEDIA but defines parameters from inside the step enclosure. 


media name is made up of two parts: XXYYYY 


XX identifies either a character set code or an index table 

YYYY identifies either a form number or an editing table 

1.€., ASSIGN DEVCLASS = device class MEDIA = 
XXYYYY 


These two parts refer to tables stored in the system; as a consequence, these tables 
must be stored in the system before being used by a user program. 


XX 


Printer Initialization 


a Vv wee Vv 
HD KPRU BPRU BPRU | up to amaximum 7 BPRUs 
I.E. 
IPRU KPRU, BPRU KPRU, BPRU KPRU, BPRU 
p / couples 
YYYY 
FORM : 
~ 
—~ \ 
io, ee v v 
KPRU VPRU PPRU 
I.E. 
EPRU FPRU | VPRU | PPRU 


XX KPRU + IPRU ARE MUTUALLY EXCLUSIVE 
YYYY FPRU + EPRU ARE MUTUALLY EXCLUSIVE 


Figure D-2. ‘Item Links 
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D.3.3.3 Use of a Permanent SYSOUT File 


S JOB...; 

STEP PROGA,...; 

ASSIGN OUTFILE, PRINT, DEVCLASS = MT/T9, MEDIA = 1601; 
SYSOUT OUTFILE; 

ENDSTEP ; 

SENDJOB ; 


NOTES: 
1. The output created by the PROGA step is stored on a magnetic tape having 
the name 1601. 


2. Since the MEDIA parameter is not present in the SYSOUT statement, the 
standard character set and paper form are to be used. 


3. The output data will be printed by the Output Writer. If the SYSOUT 
statement had been omitted, this job would not print the output data. 


4. After it has been printed, the output data remains available on the magnetic 
tape and can be printed again in another job by means of the JCL 


command WRITER: 

SJOB...; 

WRITER (PRINT, DEVCLASS = MT/T9, MEDIA = 1601); 
$ ENDJOB; 


D.3.4 Index Table - as an Alternative Character Set 
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An Index Table is a set of 7 couples (maximum) translation table-belt image. A 
Translation Table may be associated with each belt image, but is not mandatory for 
a belt image to have a Translation Table. By this means it is possible to put belt 
images or different classes (i.e. 48 characters, 63 characters, 94 characters, 64 
characters) in the same group; this is not possible with the character set. The space 
value of all belts in the same index table must be the same. 


This can best be understood in an example: 
Assume that the installation has two belts: 


e the first belt is able to print 63 EBCDIC characters (upper-case letters, numeric 
digits and special characters). It is called E500, 


e the second belt is able to print 94 EBCDIC characters (lower-case letters, capital 
letters, numeric digits and special characters). It is called E600. 
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Now, a memory byte containing a character code may be one of the following 
types: 


e printable by both belts (e.g., upper-case letters, numbers), 
e printable by one belt only (e.g., lower case letters), 
e not printable by either belt. 


Assume that a user program creates output records containing both upper-case and 
lower-case letters. Belt E600 must be used to print this output correctly: however, it 
might be useful to be able to print the output using belt E500, in the event that belt 
E600 should be unavailable. This can be done by translating every lower case letter 
into the corresponding upper-case form. 


From the point of view of the software two index tables are defined: 


e an index table called I1 which contains the E500 belt image with a translation 
table and the E600 without the translation table 


e an index table called I2 which contains only the E600 belt image. 


With the index table I1, the output is printed either with the E600 or E500 belt. If 
there are some lower-case letter codes in the output and the E500 belt is mounted 
on the printer, the lower case letters will be translated into upper-case. If the E600 
is mounted, upper and lower-case will be printed. Only one belt image is necessary 
to describe a belt. As can be seen from this example, the index table offers more 
flexibility than the character set. 


In this case, if the belt mounted on the printer is E500 and the index table specified 
is 12, then the E600 belt will be requested for mounting. 


To continue our example, the URINIT run which would define the index table 
would be as follows: 


MOVE J1 , KPRU = ( HEXTBL = '-' ); 
MOVE EH112-63 , BPRU = ( BELTCODE = 0 

, SP VALUE = 40 

, IN VCHAR = 70 

, LENGTH = 63 

( HEXTBL = '-' ); 


MOVE E600 , BPRU = ( BELTCODE = 600 
, SP VALUE = 40 
, IN VCHAR = 70 
, LENGTH = 240 
( HEXTBL = '-' ); 
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MOVE E700 ,  BPRU = ( BELTCODE = 700 
, SP VALUE = 40 
, IN VCHAR = 70 
, LENGTH = 80 
( HEXTBL = '-' ); 

MOVE Il , IPRU = ( ( KPRU = J1 _, BPRU = E700) 
1 ( KPRU = J1 , BPRU = E500) 
1 ( KPRU = J1 , BPRU = E501) 
1 ( KPRU = J1 , BPRU = E502) 
1 ( KPRU = J1 , BPRU = E503) 
1 ( BPRU = E600) 

MOVE I2 , IPRN = ((BPRU = E600)) ; 


All the characters found in all the belts linked to or associated with a translation 
table must also be found in the table at the location specified by their hexadecimal 
value. 


EXAMPLE: 


belt E703 a 
table 12 
displacement A4 


A4 


If in table I2, 4A is replaced by DO it would be a fatal error. 


You can translate any character not located in the belts into a belt character. 
Q) 


EXAMPLE: 
to translate code "20" into letter A(C1): 


e "20" must not be found in the belt images linked to the table. 
e "C1" must be found in all the belt images linked to the table. 
e the "C1"th entry of the table must contain Cl. 
e the "20"th entry of the table must contain Cl. 


Q) 
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D.3.5 Printer Character Sets 


A character set is a group of characters that can be printed out by a given printer 
belt or drum. It is recorded as a configuration of coded bytes in memory, and may 
or may not involve a translation table. 


There are 2 character sets defined: 
11 |2 


64 char 94 char 


Character set I2 


No 
Translation belt description belt 


E600 - 94 p> —600 


Character set I1 ee 
belt description ee 


E600-63 | 
Translation belt description belt 
Table E500 p> | £500 


Figure D-3._ Character Set Rules 


NOTES: 


1. Belt descriptions should be provided for E600: one for character set I2, and 
one for character set I1. 


2. When I] is requested, the lower-case letters are translated into capitals 
even if E600 is used for actual printing. 


3. Translation tables and belt descriptions are correlated. 
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Index table |2 
belt description belt 
4 
Index table |1 Trans- ee 
BPRU = E600 ston ||) sane en belt 
| table E500 E500 
BPRU = (E500,KPRU=J1) J1 
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Figure D-4. ‘Index Tables Rules 


NOTES: 
1. Only one belt description for belt E600. 


2. When I] is requested and belt E600 is used, the translation table is not 
used i.e. lower-case letters are printed as such. 


A character set therefore consists of: 
e a given group of characters, 


e an optional translation table to establish a correspondence between every 
memory byte configuration and: 


a character belonging to the defined group, 


a character used to indicate an invalid code (i.e., memory byte configuration not 
corresponding to any character in the set). 


For our purposes, a character set is defined by: 


e abelt segment image table, 


e an associated translation table (optional). 
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A belt segment image table is an image in memory of one segment of a printer belt; 
you will recall that a belt consists of several segments, each containing all the 
characters the belt is able to print. The segments are repeated to form an endless 


loop. 


Assume, for example, that belt E500 consists of segments containing: 


ABest Zo Ln2 Qiihe = 


? 


whereas a belt E600 segment contains: 


AB...Zab...9+4+- 


? 


Belt E600 could be used to print both the XY and the WZ character sets. When 
used to print WZ, the belt image (in hexadecimal code) will be: 


HEXBELT = ~C1C2 


E9 81 82 


...-A9 Fl F2 ...F9 4H 60 OF ...' 


For XY, the corresponding belt image will be: 


HEXBELT = ~C1C2 


The ‘‘invalid" characters ab. 


value *‘00". 


E9 00 00 


...00 Fl F2 ...F9 4E 60 6F...' 


..Z in the above example have been assigned the 


To continue our example, the URINIT procedure which defines these two character 


sets and their related belts is: 


MOVE E500, BPRU =(BELTCODE=500, SPVALUE=40, INVCHAR=7C, 
HEXBELT=~C1 C2 . EQ Fl F2 ...F9 4E 60 6F ...'); 
MOVE E600-63, BPRU =(BELTCODE=600, SPVALUE=40, INVCHAR=7C, 
HEXBELT='C1 C2 . E9 00 00 ...00 Fl F2 ...F9 4E 60 6F 
Pan ie 
MOVE E600-94, BPRU =(BELTCODE=600, SPVALUE=40, INVCHAR=7C, 
HEXBELT='C1 C2 . EQ 81 82 ...A9 Fl F2 ...F9 4E 60 6F 
PD 
MOVE J1, KPRU = ('00 C1 C2 C1 C2 .')j 
MOVE J2, KPRU = (); 
LINK KPRU = J1, BPRU = (E500, E600-63); 
LINK KPRU = J2, BPRU = E600-94; 
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The first MOVE command, above, establishes in SYS.URCINIT a belt image 
having the name E500, associated with physical belt type 500. The code for a space 
(blank) character is defined as hexadecimal 40 (SPVALUE). The code for an 
invalid character (INVCHAR) is hexadecimal 7C; that is, any invalid byte 
configuration in memory will be printed out as $. The characters contained in each 
segment of the belt are listed, in the same order as they appear on the physical belt, 
in the HEXBELT parameter. 


The second MOVE command establishes another belt image, named E600-63. This 
belt image is associated with physical belt type 600, which itself contains the full 
94-character EBCDIC set, but all the lower-case letters are here defined as non- 
printable by means of 00 codes in the HEXBELT list. The same values are used for 
space and invalid characters as in E500. 


The third MOVE command establishes a belt image named E600-94, also 
associated with physical belt 600, but this time allowing both the upper-case and 
lower-case letters to be printed. Again SPVALUE and INVCHAR are the same as 
in the other belt images. 


The next two MOVE commands establish character sets J1 and J2 in 
SYS.URCINIT. Character set J1 (no lower-case letters) has a translation table 
associated with it so that it can be used with the E600-63 belt as well as with the 
E500 belt. 


Finally, there are two LINK commands to establish the relationships between 
character sets and belt images: J1 is linked to belt images E500 and E600-63, J2 to 
belt image E600-94. 


D-25 


GCOS 7 System Operator's Guide 


Table D-4. 


Character Sets and their Belt Images 


INDEX CONTENTS RELATED BELT 
TABLE 
NAMES 


Il 


[2 


13 


14 


15 


17 


Gl 


G2 


G3 


G7 


63/94 EBCDIC characters 
printing of lower case letters if 
belt E600 

94 EBCDIC characters 


(upper and lower case letters)* 


96 characters 


64 characters 


63 EBCDIC characters 


64 characters 
(of which 15 CMC7) 


64 characters G100 


64 characters G100 


64 characters G100 


64 characters G100 


E703, E500 


E600 for PRU 1200/1600 
EH112-63 for PRU 600/800 
B600 for PRU 0615 


E600 for PRU 1200/1600 
EH112-96 for PRU 600/800 
B600 for PRU 0615 

E700 

E501, E502, E503, E504, E505, 
E511 

E511, E512, E513 for 

PRU 1200/1600 

E151-64 for PRU 0711 

G700, G500 for G600 

PRU 1200/1600 

GH112-63 for PRU 600/800 
G601 for PRU 0615 

G501, G502 for PRU 1200/1600 


GH112-96 
G601 


G151-64 


* Kept for compatibility 
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D.3.5.1 Standard Index Tables 


The following standard index tables are supplied by BULL: 
I1, I1, 13, 14, I5, 17; and, for G100, Gl, G3, G7. 


e I1 identifies the EBCDIC set. All lower-case letters are changed to capital letters 
except for the E600. The commercial at symbol (@) is substituted for all non- 
printable characters. The standard space code (blank character) is 
hexadecimal 40. 


e [2 identifies the standard 94-EBDIC set, including lower-case and upper case 
characters. 


e 14 identifies the standard 64-character set. 
e 15 identifies the 63-character EBCDIC code (like I1, above). 


These character sets and their associated belt images are summarized in Table D-4. 


D.3.5.2 KPRU Parameter 


The SYS.URCINIT item KPRU defines the translation table. It contains a single 
parameter, HEXTBL. In the URINIT MOVE command, for example, it has the 
form: 


MOVE table-name, KPRU = ([HEXTBL = 'Hexa — 512']); 


HEXTBL is the hexadecimal translation table (optional) used to translate from 
internal code to print belt image. It contains 256 entries, each entry being a 2 digit 
value. When creating or modifying a translation table, keep the following points in 
mind: 


e All the characters found in a translation table must also be found in the belts 
linked to that table, or in the associated belt in the index table. 


e Any character found in any belt linked to or associated with a translation table 
must be found in the table at the location specified by its hexadecimal value. 
For example, character 4A in belt E500 must be found in table J2 at 
displacement 4A. 


e Any code not already referring to a belt character can be related to a belt 
character. 
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D.3.6 


D.3.6.1 
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NOTES: 


1. Ifthis type of translation function is not required, then a translation table is 
not necessary. 


If a belt character is to be changed into another belt character, then the belt 
image rather than the translation table should be changed. 

For example, if the letters A and S are to be interchanged, when A is Cl and 
S is El, simply change S to Cl and A to El in the belt image. 


If a certain character is never to be printed, insert hexadecimal **00** in the 
corresponding entry of the belt image. 


2. The character string must be protected. (See Section D.2.5 Protected 
Character Strings) 


Belt Definition 


A character set can have up to seven belt image records associated with it, each 
identified by a BPRU item. 


An index table can have up to seven couples of translation tables and belt images. 


BPRU Parameters 


Again taking the MOVE command as an example, BPRU has the following form: 


MOVE table-name, BPRU = (BELTCODE = 'digits-3', 
SPVALUE = 'hexa-2', 

INVCHAR = 'hexa-2', 

HEXBELT = 'hexa-n belt image', 
CHARBELT = 'char-n belt image' 
[LENGTH = { 240 }] 

[ { 'digits-3' } ] ); 


BELTCODE Physical identification of the belt, or drum code (0000) 
in the case of a drum-type printer. 


SPVALUE Space code value; character to be interpreted as a 
space and never printed, even if it belongs to the belt 
image. 


INVCHAR Value of substitution character to be printed if an 
invalid character is requested (i.e., a character which 
does not belong to the belt image). The substitution 
character specified must be a printable character. 
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HEXBELT-CHARBELT _ Belt segment image, in hexadecimal or alphanumeric 
characters. It does not refer to any physical 
characteristic of the drum, as the belt codes do in the 
case of a belt. 


LENGTH Length of the belt image, in characters (bytes). The 
default value is 240. 


NOTES: 


1. With respect to CHARBELT, it is possible to introduce an internal code 
different from EBCDIC. 


2. For both HEXBELT and CHARBELT, the character string must be 
protected. (See Section D.2.5 Protected Character Strings) 


D.3.6.2 IPRU Parameters 


This table is used to associate several belt images (BPRU) with their translation 


tables (KPRU) 
MOVE table name, IPRU ((BPRU = name [,KPRU=name] ) 1 couple 
[(BPRU = name [,KPRU=name])...) 2 couples 
etc 


BPRU = name of belt image 


KPRU = name of translation table 


NOTE: 
IPRU is better and simpler to use than the links between KPRU and BPRU 
(character set definition). 


For example, an installation has two belts: 


e the first belt, named E500, has 63 characters, 
e the second belt, named E600, has 94 characters. 


47 A2 53US D-29 


GCOS 7 System Operator's Guide 


From the point of view of the software, the two index tables are defined as follows: 


e Index table I1. I] contains the E500 belt image with a translation table (lower 
case to upper case) and the E600 without translation. 


Using index table I1, the output can be printed either with E600 or E500. If there 
are lower case letter codes in the output and E500 is mounted on the printer, the 
lower case letters will be translated into upper case. If E600 is mounted, upper 


and lower case will be printed. 


e index table I2, which is used to print with the E600 belt only. If the belt mounted 
on the printer is E500, the E600 belt will be requested, as explained below. 


If the index table specified is not supported by a currently mounted belt, a message 
will request the operator to mount the proper belt, whose identification code is 
given in the message. In the case of a non-standard belt, and especially one 
modified by the user, care must be taken to ensure that a change in belt image is 
reflected by a change in belt code, and that a correlation list is available to the 


operator. 


As an example, belts E700, E501, associated with character set I1, would be 


defined as follows: 


MOVE E700, BPRU = 


INVCHAR = 7C, CHARBELT = 


MOVE E501, BPRU = 


INVCHAR = 7C, CHARBELT = 


MOVE I1, IPRU = 


D.3.7 Form Number Encoding 


700, SPVALUE = 40, 
'01234....... ')5 


501, SPVALUE = 40, 
WB OTB is 64 08 3% CDEF" '); 


J1, BPRU = E700) 


(KPRU = J1, BPRU = E501)...); 


The form is specified by the user in the MEDIA parameter of the ASSIGN JCL 
statement. However, the form number is only part of it (the last four bytes), the first 
two bytes being reserved for the character set code or the index table. 
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D.3.8 Editing Table - as an Alternative to Form-Name 


An editing table is a group of three elements: 


e form number, which is mandatory, 
e vertical form unit, 
¢ printing test. 


The last two elements are optional. When the three elements are present, it is 
equivalent to a form having a link to a VFU (Vertical Form Unit), this VFU having 
a link to a printing test. 


D.3.9 Form Definition 


The form (i.e., the paper to be used for printing) is treated by the system as an 
unlabelled volume which must be mounted at the beginning of a work session. It is 
identified by a form number, which is specified in the second field of the MEDIA 
parameter. (See Device Naming and Allocation, above.) The form number is 
recorded in SYS.URCINIT, and certain characteristics and printing rules can be 
recorded at the same time, as described below. Three standard forms are predefined 
by GCOS, as explained below. 


D.3.9.1 Standard Editing Table 
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The editing table is initially defined by a code in the last four bytes of the MEDIA 
parameter at assignment time. The printing parameters of the form which belong to 
the standard editing table are: 


Code ~~0000~~ 


Form height : 66 lines 
Margin : 0 

Head of form > 5 

Full form 1 : 60 
Printing density : 1/6 inch 


Vertical format stops: Channel 1, level 05 
Channel 2, level 10 
Channel 3, level 40. 


Code *‘0000"° is identical with the above except for printing density, which is 1/8 
inch. 
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D.3.9.2 EPRU Parameters 


EPRU parameters contain the names of the items defined for printing: 


FPRU = name 
[, VPRU = name] 
[, PPRU = name] 


FPRU = name of existing form 


VPRU = name of an existing vfn 
PPRU = name of existing printest 
EXAMPLE: 
MOVE FOOO , FPRU = ( FORMHT = 66+4n1 
, HOF 5 
7; EE = 60 
ane 
MOVE FOOL , FPRU = ( FORMHT = 88 
, HOF 5 
, FFL 80 
, PRDEN = 8 
ae 
MOVE H-DF-VFU , VPRU = ( CH1 = 5 
, CH2 = 10 
, CH3 = 40 
ae 
MOVE 0000 , EPRU = ( FPRU = FO0O00 
, VPRU = H DF VFU 
) 
MOVE 0001 , EPRU = ( FPRU = FOOL 
, VPRU= H_ DF VFU 
ae 
QO 
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D.3.9.3  FPRU Parameters 


The following parameter keywords are specified in item FPRU to define the 
physical characteristics of the paper mounted on the printer. 


MOVE form-name, FPRU = (FORMHT = ‘digits 3' 


[ 1-0 } ] 
[,MARGIN = { }] 
[ { margin-value } ] 


[ {2 eal 
[,HOF = { a 
[ { head-of-form } ] 


[ { FORMHT }] 
[,FF1 = { }] 
[ { full-form-1 } ] 


{6} ] 
[, PRDEN = { | Se es 
L834 


8 


FORMHT Height of the paper form in number of lines; 3 digits 
maximum. 


MARGIN Number of columns to be skipped at the left of the 
paper form; 3 digits maximum. 


HOF Head of form. Line number of the first line printed in a 
output page; 3 digits maximum. 


FF1 Full form level 1. Line number from the upper fold of 
the paper form. Used for indicating a full page; 3 digits 
maximum. 


PRDEN Printing density in number of lines par inch. The 
distance between any two consecutive lines may be 1/6 
inch or 1/8 inch; *’6** in this parameter means 1/6 and 
“8°. means 1/8. 
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The following remarks may be helpful in understanding how these parameters are 
used: 


e Assume that form 0009 is used, with the values FORMHT = 66, MARGIN = 0, 
HOF = 1, and FF1 = FORMHT. 
As indicated in Figure D-1, line 1 is the first possible line on the page, lying just 
beneath the fold of the paper form, and line n is equal to line 66 (defined by 
FORMHT). Let P be the current printing position on the paper. Now, if the 
COBOL program specifies: 


WRITE record-1 AFTER ADVANCING PAGE 
then record-1 will be printed in the position indicated as P1 (i.e., line 1 of the 
next page). In the same fashion, if the program specifies: 


WRITE record-1 AFTER ADVANCING 4 LINES 


then PO and P1 would be separated by three blank lines. 


e Now assume that the Head of Form and Full Form | parameters are as normally 
specified in form 0000 (HOF = 5, FF1 = 60) and that MARGIN = 7. 
In effect, these parameters define a logical page lying within the physical page, 
as illustrated in Figure D-2. The first line which will actually be printed (logical 
line 1) will be on physical line 5, as defined by HOF, and the last line printed on 
the page will be line 60 (defined by FF1). As a result, each printed page will 
have four blank lines left at the top and six blank lines left at the bottom. In 
addition, seven columns will be left blank at the left-hand side to serve as a 
margin. Now if the COBOL program specifies 


WRITE record-1 AFTER ADVANCING PAGE 


then record-1 will be printed on line 5 of the next page; if the program specifies: 


WRITE record-1 AFTER ADVANCING 4 LINES 


then the two printed lines will still be separated by three blank lines, as in the 
previous example. 
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PAPER FOLD =} 22ss0222s2eseosceeessasseesses dt semeseeamsn ss 
<q LINE 1 
> LOGICAL 
fy PAGE 
<q LINE 66 
PAPER EOD terete eater te doce ae 
P—> <q LINE 1 
_ i s 7 oN 
PAPER FOLD “(eaeses-aescccsesescccsceeccnas eeseceseaces 
<q LINE 1 
4 LINE 5(HOF) 
<q LINE 60(FF1) 
<q LINE 66 
PARE FO MM stata eta cia anereani arian peau te eset ae 
<q LINE 11 
<q LINE 5(HOF) 


Figure D-5. Form Parameters 


47 A2 53US D-35 


GCOS 7 System Operator's Guide 


The MEDIA parameter (see Device Naming and Allocation, above) is used to 
define both the index table and the editing table. For example, index table 12, 
editing table 0003 would be specified as follows: 


SYSOUT PRINT, DEVCLASS = PR, MEDIA = 120003; 


Use of the URINIT MOVE command for the editing table and form parameters in 
the SYS.URINIT file can be illustrated as follows: 


(Recording of standard print form F000) 


URINIT COMFILE = *CATA; 

SINPUT CATA; 

MOVE F000, FPRU = (FORMHT = 66, PRDEN = 6, HOF = 5, FF1 = 60) 
MOVE 0003, EPRU = (FPRU = F000); 

SENDPUT 


See also Parameter Overriding below. 


D.3.10 Vertical Format Definition 
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VPRU Parameters 


The parameters specified in item VPRU define the distances, in line spaces, 
between the upper fold of the paper form and the various form feed stop levels. 
This facility therefore provides a software simulation of the VFU tape loop often 
used in printers for vertical format control. 


At least one of the following parameters must be specified: 


MOVE table-name,VPRU = ([CH1 = (channel-1-1[,channel-1-2]...)] 
[,CH2 = (channel-2-1[,channel-2-2]...)] 

[,CH3 = (channel-3-1[,channel-3-2]...)] 

[,CH12 = (channel-12-1[,channel-12-2]...)]); 


CH1 through CH12 refer to channel numbers; the content of each CHn is a list of 
all stop levels in that channel. The levels for a given channel must be entered in 
ascending order, and the highest level must be less than the form height value. Up 
to 20 levels are allowed, distributed over 12 possible channels. 
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Assume, for instance, that stop levels are desired for line 5 on channel | and for 
lines 20 and 48 on channel 2. This information would be entered into 
SYS.URCINIT as follows: 


URINIT COMFILE = * CATA; 
SINPUT CATA; 

MOVE VFUI, VPRU = (CH1 =(05), CH2 = (20, 48)); 
SENDINPUT ; 


VFU parameters are frequently associated with the form specifications, so that 
whenever the form is used the associated VFU is also available for use. To 
associate VFU1 to paper form F001 the following command would be given: 


MOVE 0001, EPRU = (FPRU = F001, VPRU = VFU1); 


Certain VFU formats are normally associated with standard paper forms, as noted 
in ‘Form Definition’, above. 


D.3.11 Printing Test Definition 
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The printing test consists of one or more lines which are printed out whenever the 
operator presses the PRINTER TEST switch (e.g., at the beginning of a job or 
following a fault condition such as torn paper). 


It is used to ensure that the paper form is correctly mounted in the printer, both 
horizontally and vertically. The standard printing test supplied by BULL consists of 
a line of Es printed on line 1 of the form (just below the fold). You may specify 
your own printing test by means of the PPRU parameter. 


PPRU Parameters 


The parameters specified in item PPRU define the format and content of the test 
printout, as follows: 


MOVE table-name, PPRU= ( (FORMCTL=form-control, 
{HEXLINE= 'hexadecimal-line-description' } 
{ CHARLINE='alphanumeric-line-descriptionn' } 


[ (FORMCTL=form-control, ] 
[ {HEXLINE='hexadecimal-line-description' }] 
[ {CHARLINE='alphanumeric-line-descriptionn' }] 


FORMCTL: this 2-byte header parameter defines the number of 
lines the paper is to be moved prior to or following the 
printing of the test line, as explained in Table D-5. 
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EXAMPLES: 


FORMCTL = 0001: Move paper one line before printing test line. 


FORMCTL = 8205: Jump to line 5 after printing test line. 
QO 


Table D-5. Test Format Control Bytes (FORMCTL) 


Character 1 Character 2 Characters 3 and 4 


0 = move paper n lines as 00 to FF1 (or FORMHT) 
defined in binary by 
0 = move paper before 
printing 1 =jump to reference level* | 00 


2 =jump to line defined in 
binary by 01 to FORMHT 


3 =jump to channel n, as 
defined in binary by 01 to OC 


8 = move paper after 
printing 4 = same as 0 but with 00 to FF1 (or FORMHT) 
FF1 protection 


HEXLINE/CHARLINE: 


Describe the line to be printed in hexadecimal or alphanumeric characters, 
respectively. For both HEXLINE and CHARLINE the character string must be 
protected. (See Section D.2.4 Protected Character Strings). 


With respect to CHARLINE, it is possible to introduce an internal code different 
from EBCDIC. 


To define a 2-line alphanumeric printing test in SYS.URCINIT, for example, the 
user can specify: 


MOVE AB PPRU= ( 
(FORMCTL=0001, CHARLINE= 'XXXXXX') 
(FORMCTL=0204, CHARLINE='YYYYYY') ); 


A printing test can also be associated with a paper form or with a VFU format. For 
form: 


LINK FPRU=0002, PPRU=AB; 
or 
LINK VPRU=VFU1, PPRU=AB; 
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Ifa VFU format is already linked to a specific form, the printing test must be 
linked to the VFU, not to the form. 


For editing table: 


MOVE 0003, EPRU = (FPRU=F002 
PPRU=AB) ; 


or 


MOVE BLUE, EPRU = (VFRU = VFU1 
PPRU = AB); 


D.3.12 Parameter Assignment Restrictions 


Initially, the following relationships must hold true among the printing parameters: 


FORMHT > 0 

HOF <  FORMHT 

FF1 < FORMHT 

If HOF not = 0, then HOF < FF1 


Parameters must also be consistent with the printer capabilities as noted in Table D- 
2. For example, for the PRU 1200/1600 printers 


If PRDEN=6 then 24 <= FORMHT <= 144 
If PRDEN=8 then 32 <= FORMHT <= 192 


If the user changes the printing density without changing the form height value, the 
form-height value must fit the printing density within 1/2 inch. 


The margin value may vary in accordance with the type of printer and form used. 
However, when using this parameter, the user must ensure that the margin plus the 
number of printed characters does not exceed the number of hammers on the 
printer (as may be specified in DEVCLASS). 


e The absolute stop levels given in vertical format control must not exceed the 
value of FORMHT. 


e The substitution character must be a printable character. 


e The line images specified for the print test must be consistent with the character 
set codes. 
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D.3.13 Parameter Overriding 
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The character set code/index table and the form number/editing table, are entered 
into the system during Device Naming and Allocation, as described above. The 
following information must be stored in the system with the form number: 


the form height (FORMHT), 

the printing density (PRDEN), 

the margin (MARGIN), 

the full form and head of form levels (FF1, HOF), 
the vertical format tape image (VFU). 


A print test may be linked to the VFU information at this level; if no VFU is 
specified the print test may be directly linked to a form. 


The following information may be entered at execution time (e.g., by means of the 
JCL Statement DEFINE) and if given overrides the values entered by the MEDIA 
parameter at device naming and allocation. 


e form height (FORMHT), 

e printing density (PRDEN), 
e margin (MARGIN), 
e full form and head of form levels (FF1, HOF), 


e vertical format with or without linked print test, by redefining each channel 
(CH1, CH2, etc.), 


¢ print test. 


With regard to the print test, the override rules are summarized below: 


Table D-6. Print Test Overriding 


ORIGINAL VALUES PRINT TEST RESULTING FROM 
(MEDIA) DEFINE CH1/CH1 


VFU, PRTEST Print test associated with Form. 
VFU, no PRTEST Standard Print Test. 
no VFU, PRTEST Print Test associated with Form. 
no VFU, no PRTEST Standard Print Test. 
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D.3.14 ASA Data Format 


On the programming level, several internal data formats can be used in preparing 
the records to be printed out. SSF and SARF formats are treated in other manuals 
(see especially the COBOL User Guide); this section summarizes the American 
Standards Association (ASA) format. The ASA data format can apply to standard 
SYSOUT subfiles and to permanent SYSOUT files. Refer to the JCL User's Guide 
for information on the different types of SYSOUT files. The use of ASA format 
with these SYSOUT facilities is illustrated below. 


D.3.14.1 General Programming Notes 


In ASA format, each internal record corresponds to a line to be printed out. The 
first byte in each record is a control character as defined in Table D-5. The control 
character is not printed, but it must be created by the user. 


When preparing ASA records in COBOL, note that SYSOUT and PRINTER must 
not be specified in the ASSIGN clause. Rather, the specification should be only: 


ASSIGN TO i fn 
In the file description, specify 
WITH ASA 


In the WRITE verb, the vertical line positioning options must not be used. 


D.3.14.2 ASA Format Using Standard SYSOUT Subfiles 
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Printing or editing parameters can be specified by means of the JCL statement 
SYSOUT. 


For printing out ASA records via a standard SYSOUT subfile the JCL would be: 


STEP PROGA,...; 
SYSOUT OUTFILE; 
ENDSTEP; 


and the COBOL program would be: 
SELECT OUT 
ASSIGN TO OUTFILE 
WITH ASA. 


FD OUT 
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RECORDS CONTAIN 101 CHARACTERS 
LABEL RECORD IS OMITTED. 


OPEN OUTPUT OUT 


WRITE record-name 


CLOSE OUT 


D.3.14.3 ASA Format Using Permanent SYSOUT Files 
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ASYSOUT JCL statement must be specified to enable the file to be printed out. 


FOR EXAMPLE: 


e JCL statements: 


STEP PROGA,...; 

ASSIGN OUTFILE, ASA-FILE, DEVCLASS=MT/T9, MEDIA=TO38; 
SYSOUT OUTFILE; 

ENDSTEP ; 


e COBOL program 


SELECT OUT 
ASSIGN TO OUTFILE 
WITH ASA. 

FD OUT 


RECORDS CONTAIN 101 CHARACTERS 
LABEL RECORD IS OMITTED. 


OPEN OUTPUT OUT 
WRITE record-name 


CLOSE OUT 
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E. WHEN, EVERY and RRESTART 


WHEN 


Absolute Addressing 


WHEN or WHEN=IMMED allows the request to be enqueued immediately. 


WHEN=date_time allows the request to be enqueued and executed on the given 
date at the specified time. However, if the time is prior to the current time, the 
request is cancelled with an error message. 


Date_time has the format: 
month.day. [yy] yy. hh. mn, 
where the separators canbe: . or : or / 


month can be a number from | through 12 or the first 3 letters of the month such 
as JAN or MAR. 


day can be: 


e if the month is after the current month and is therefore explicitly specified: 
— either a number from | through 31, 


— or LAST-n* where n is a number from | through 3 concatenated to the name 
of the day, being the first 3 letters such as JAN:LAST-1*MON 1992, meaning 
the last but one Monday of January 1992 


e if the month is current and therefore omitted: 
— either a number from | through 31 concatenated to *DAY, meaning the nth 
day of the current month 


— oranumber from 1* through 4* concatenated to the name of the day, being 
the first 3 letters of the day such as 2*TUE, meaning the second Tuesday of 
the current month 
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— or LAST concatenated to *DAY, meaning the last day of the current month 


— or LAST-n where n is a number from 1 through 15, meaning n days before the 
end of the current month. 


The expression *DAY can also apply to *WKD (working day) or *NWKD 
(non-working day). 


e if the day is relative to today either in the form of TOM (tomorrow) or NXW 
(next week), in which case the month can either be current or the month 
following, see E.1.3 Fast Options. 


e if the day and/or time have lapsed in which case, FORCE enables the request to 
be immediately enqueued for execution, see paragraph E.1.4 FORCE Option. 


year can be expressed either as 2 digits such as 91 or 4 digits such as 1991. 


hours and minutes are expressed as digits in the order indicated. 


EXAMPLES: 


WHEN=20*DAY:10:00 
request to be enqueued and executed on the 20th day of the current month at 10:00. 


WHEN=LAST*DAY/7 :00 
request to be enqueued and executed on the last day of the current month at 7:00. 


WHEN=3*MON/18 . 00 
request to be enqueued and executed on the third Monday of the current month at 
18:00. 


WHEN=LAST-2:10.34 
request to be enqueued and executed 2 days before the end of the current month at 
10:34. 


WHEN=JAN . LAST-1*MON.1992.12:30 
request to be enqueued and executed on the last but one Monday of January 1992 
at 12:30. 


WHEN=12.25.91.6.30 
request to be enqueued and executed on December 25, 1991 at 6:30. 


Q) 
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E.1.2 Relative Addressing 


WHEN=+delay gives the interval before the request is enqueued. 
Delay is a signed (+) number of: 


weeks (W or WEEK) 
days (D or DAY) 
hours (H or HOUR) 
minutes (M or MIN). 


Delay must be greater than 1 minute. The maximum delay period, specified as a 
number of up to 5 digits, is 45 days, 12 hours and 15 minutes. 


EXAMPLES: 


WHEN=+H3 0M 
enqueuing and execution in | hour and 30 minutes. 


WHEN=+2D 
enqueuing and execution in 2 days. 


WHEN=+4W2D 
enqueuing and execution in 4 weeks and 2 days. 


Q) 


E.1.3 Fast Options 
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Abbreviations are available as acronyms, namely: 


TOM for tomorrow 

NXD.WKD for next working day 

NXD.NWKD for next non_working day 

NXD for next day 

NXW for next week 

and the first 3 letters of the day such as WED for Wednesday. 


The default day for next week is Monday and the default time is 00HO00. 


EXAMPLES: 


WHEN=TOM 
the request is enqueued tomorrow at 00H00. 


WHEN=NXD . WKD 
the request is enqueued next working day at 00H00. 
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E.1.4 


WHEN=NXD .NWKD.10.00 

the request is enqueued next non-working day at 10H00. 
WHEN=NXD 
the request is enqueued next day (tomorrow) at 00HO00. 


WHEN=NXD/TUE 
the request is enqueued next Tuesday at 00HO0. 


WHEN=NXD.TUE.8.45 

the request is enqueued next Tuesday at 8H45. 
WHEN=TOM: 14 :30 

the request is enqueued tomorrow at 14H30. 

WHEN=NXW 

the request is enqueued next week on Monday at 00HO0. 


WHEN=NXW/TUE 
the request is enqueued next week at Tuesday at 0OHO0. 


WHEN=NXW.TUE.8.45 
the request is enqueued next week at Tuesday at 8H45. 


Q) 


FORCE Option 


FORCE is useful when the requested date and/or the requested time have lapsed. 


The request is enqueued immediately for execution on the current date and at the 
current time irrespective of the submission date and/or time without an error 
message being issued. 


EXAMPLES: 


WHEN=FORCE. 10.00 submitted today at 11H00 causes the request to be 
enqueued today at 11H00 (i.e. immediately, because it 
is already later than 10HO0). There is no error 
message. 


WHEN=10.00 submitted today at 11H00 without FORCE results in 
the error message ***WHEN: ILLEGAL VALUE 
and the WHEN clause being rejected. 
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E.2 EVERY 


EVERY specifies the interval and the number of times that the request is to be 
subsequently enqueued for execution. 


The interval expressed in EVERY is equivalent to delay in WHEN, see paragraph 
E.1.2 Relative Addressing. However, the value of interval for EVERY must be 
greater than 15 minutes but less than 45 days, 12 hours and 15 minutes. 


The format of EVERY is: 
EVERY = ( [frequency] interval [times] ), 
where 


interval is limited to 12 characters and is a number qualified by: 


weeks (W or WEEK) 

days (D or DAY) 

hours (H or HOUR) 

minutes (M or MIN) 

months (MONTH) 

working days (WKD) 
non-working days (NWKD). 


times is the number of times up to a maximum of 65535 that the request is to be 
enqueued. When omitted, the request will continue to be enqueued until the user 
intervenes or the request is ultimately executed. 


If MONTH is specified, the request will be handled on the same day as the 
submission day next month. If the submission day is 31, the request will be handled 
on the Ist. of the month following the next. For example, if the submission day is 
May 31st., the request will be handled on July Ist. 


Working days (WKD) are days that belong to neither the list of non-working days 
nor the list of holidays. The system contains default lists for non-working days and 
holidays that can be modified using the MODIFY_DJP command. 
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EXAMPLES: 


EVERY=5W 
requests are to be enqueued indefinitely every 5 weeks. 


EVERY=(1D 2) 
requests are to be enqueued once every day for 2 days. 


EVERY= (20M 72) 
requests are to be enqueued 72 times every 20 minutes. 


EVERY= (4H 6) 
requests are to be enqueued 6 times every 4 hours. 


EVERY=1WKD 
requests are to be enqueued indefinitely every working day. 


WHEN=MAR.31.16.30 EVERY=MONTH 
requests will be enqueued at 16H30 on March 31st., May Ist., May 31st., ... until 
the user intervenes or the requests are ultimately executed. 


WHEN=DEC/21/1995/12/45 EVERY=WKD 
requests will be enqueued at 12H45 on December 21st, 22nd, 26th, etc. Saturdays, 
Sundays and Christmas are non-working days or holidays in the default lists. 


WHEN=OCT.1*WKD/7.30 EVERY=MONTH 


requests will be enqueued each month beginning on the first working day of 
October at 7H30. 


WHEN=NXD.NWKD.8.30 EVERY=NWKD 
requests will be enqueued every non-working day beginning on the next working 
day. 


WHEN=JAN . LAST*WKD/00.00 EVERY=MONTH 
requests will be enqueued each month on the last working day beginning January at 
midnight. 


Q) 
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E.3 RRESTART 
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WHEN, EVERY and RRESTART 


RRESTART specifies what to do with the requests which normally should have 
been handled at a time when the system was stopped for whatever reason and then 
restarted by WARM RESTART. RRESTART takes into account all system 
stoppages being normal shutdown, hardware and software failures. Requests whose 
dates are subsequent to the restarting time are not affected and will be enqueued 
normally when their time is due. 


IMMED: 
CANCEL or NO: 


delay: 


the request is immediately enqueued. 
the request is cancelled. 


delay is added to the normal enqueuing time. 
Delay is expressed in 

— minutes (M) 

— hours (H) 

— days (D) 

— weeks (W). 


Delay can be qualified by E to denote elapsed time. 
DelayE specifies the maximum delay allowed for 
enqueueing the request, on expiration of which the 
request is cancelled. 


Maximum elapsed time for delayE is set at 45 days, 12 
hours and 15 minutes. 
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EXAMPLES: 


WHEN=10.30 RRESTART=1D 

The request is to be enqueued at 10H30 in a day's time. If on the day at 10H30 the 
system is down, the request will be enqueued tomorrow at the same time. If come 
tomorrow the system is still down, the request is further enqueued for a subsequent 
delay and so on, indefinitely. 


WHEN=10.30 RRESTART=1DE 

The request is to be enqueued at 10H30 in a day's time. If the system was shut 
down (for whatever reason) and restarted, one of two actions concerning the 
request will be taken: 


e either the request will be enqueued and executed immediately if the system was 
restarted before the elapsed time expired 


e or the request will be cancelled if the system was restarted after the elapsed time. 
Q) 


NOTE: 
If the request is repetitive, the delayE must be less than the delay between two 
normal executions of the request specified by EVERY. 


E-8 47 A2 53US 


47 A2 53US 


F. Device Types and Classes 


Communication controller 


Device type: CC 


Communication link 


Device type: CL 


Cartridge 

Device type: CT 

Device classes: 

CT [/LIB] [ {/MS5|M6 
where: 


LIB 
M5 


M6 


Diagnostic interface 


Device type: DI 


|36T}] [/{ $35|S75}] [/C] 


specifies a cartridge library 

specifies a device using half-inch cartridges with 18- 
track recording format 

specifies a device using 8mm cartridges or a Galileo 
Controller. 

specifies a device using half-inch cartridges with 36- 
track recording format 

specifies a density of 35Mb / sq. inch 

specifies a density of 75Mb / sq. inch 

indicates compaction 
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Foreign controller 


Device type: FC 
(Transparent peripheral controller attached to PSI-2.) 


Device class: FC/M1 


Foreign device 


Device type: FD 
(Transparent peripheral device.) 


Line 


Device type: LN 


Logical terminator 


Device type: LT 


Mass storage controller 
Device type: MC 
Device classes: 


MC [ /{MI|MS5} ] 


where: 
Mil is for MS/B10 and MS/D500 disks 
M5 is for MS/FSA disks 


Maintenance feature 


Device type: MF 
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Device Types and Classes 


Mass storage (disk) 
Device type: MS 
Device classes: 


MS [/{FSA|B10| D500 } ] 


Magnetic tape 
Device type: MT 
Device classes: 


MT [/T9] [/ {D6250|D1600|} ] [/S] 


where: 

T9 indicates 9-track tape 
D6250 indicates density 6250 bpi 
D1600 indicates density 1600 bpi 
Ny indicates streaming mode 


On DPS 7000/XTA platform, the magnetic tape devices are seen as CT/M6 
devices. 


Printer 
Device type: PR 
Device classes: 


PR[/Hnnnn ] [/ { SI|FIJ|A}}] [/{ PR90|PR54} ] 


where: 

Hnnnn indicates nnn print positions 

SI indicates slowest printer 

FI indicates fastest printer 

A indicates any speed 

PR90 specifies a dot matrix printer 
PR54 specifies a non-dot matrix printer 
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Tape or cartridge controller 


Device type: TC 


Device classes: 


TC [/ {M3 | M4 |M5|M6|M7}] 


where: 


M3 


M4 


M5 


M6 


M7 


Unit record controller 


Device type: UC 


Device classes: 


specifies a magnetic tape ATP controller (such as 
MTP4501/02) 

specifies a magnetic tape MTC-G controller (such as 
MTS4501) 

specifies a CTS4800 cartridge controller (for 
CTU4800 drives) 

specifies an 8mm cartridge controller or a cartridge 
controller for CTSD020, CTSD030 or CTSD032 
specifies the cartridge controller for CTS6510, 
CTCCO001, or CTCC002 drives. 


UC [/ {M4|MS51 | M52 | M53} ] 


where: 


M4 


M51 


M52 


M53 


specifies the Service Processor Controller attached to 
PSI-H, or 

a multi-purpose controller attached to PSI-H, PSI-K, or 
PSI-N (CTF4502), or 

an AUSP emulated peripheral controller attached to 
PSI-E. 

specifies the Service Processor Module (controller 
attached to PSI-E). 

specifies the printer input / output module controller 
attached to PSI-2 

specifies the FDDI input / output logical controller 
attached to PSI-2, or 

the networking channel controller attached to PSI-2. 
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G. How GCOS 7 Handles Dates Before and 
After the Year 2000 


With the upcoming arrival of the year 2000, the following conventions are used in 
interpreting and entering dates in GCOS 7. 


G.1 If the Year Is Entered In Two Digits 


If a JCL or GCL command is entered with the year specified in only two digits 
(YY), GCOS 7 applies the following "61 rule" in determining the first two digits of 
the year (the century): 


e If YY < 61, the first two digits of the year are interpreted as 20 (the date has the 
format 20YY) 


e If YY = 61, the first two digits of the year are interpreted as 19 (the date has the 
format 19YY) 


The number 61 was chosen because GCOS 7 did not exist in 1961, 1961 was not a 
leap year, and January 1, 1961 was a Monday. 


EXAMPLES: 


e In files (when format is YY/MM/DD): 
EXPDATE = 03/07/11 Date is July 11, 2003 

e Injournals (when format is YY.MM.DD): 
ENDDATE = 02.04.12 Date is April 12, 2002 
BEGDATE = 98.01.17 Date is January 17, 1998 

QO 
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G.2 Entering YEARs in GCL 


In GCL, the year can be specified using two digits or four digits at any time. Ifa 
year is entered using four digits, GCOS 7 checks that the year is between 1961 and 
2060. 


For example, to specify the date March 2, 2001 (format: YY/MM/DD), the user 
can enter: 


EXPDATE = 01/03/02 
or 


EXPDATE = 2001/03/02 


In the first example, GCOS 7 applies the 61 rule and interprets the year as 2001. In 
the second example, GCOS 7 checks that the year is between 1961 and 2060. 
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H. Queued Writer 


H.1 Queued Writer Overview 
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The QUEUED WRITER is a writer that manages the printing of all outputs via an 
SL library, whereas usual writers can only send outputs to sequential files. 


It is started and terminated like any writer by the START _OUTPUT_WRITER 
(SOW or SO) and TERMINATE _OUTPUT_WRITER (TOW or TO) commands. 


The QUEUED WRITER is automatically activated when a writer is started for a 
file and this file is found to be a library. The selection and priority rules for the 
outputs are the same as for any other writer. The members will be created in SSF 
or ASA format in accordance with the specification in the SO command. The 
treatment of output banners is the same as for other writers. 


The only prerequisite for using the Queued Writer is that the library to which you 
send outputs must already exist (the Queued Writer will not create it). 
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H.2 Definitions of Terms 


The following terms and abbreviations are used in this Appendix: 


SYS.OUT 


RON or ron 


outindex 


JOB_REP or JOR 


JOB_OUT 


destination 


station 


secondary_ station 


Resident Linked-Queued file in Virtual Printing 
Format (VPF). 


Run Occurrence Number given by the JOB Manager 
(JOBM) to each Job: the name "Xron" is assigned to 
the Job. 

Suffix given to each output generated within a given 
Job. It is the number "i" in: "Xron:i". 

Job Occurrence Report: it is an SSF file with the name 
"Xron:1". It is created by the JOB Manager to report 
Job execution. Its format is SSF (System Standard 
Format). 


Output created automatically by the Output Writer 
with the name "Xron:2". It contains the outputs 
created by the Job Xron if their output parameters 
(class, copy, etc.) are the same as those of the JOR. 
These outputs are named "Xron:2:j" where "j" is a 
sub-index. Other outputs will receive a name in the 
form "Xron:k" with k greater than 2. If the JOB_OUT 


is empty, it is deleted at the end of the Job. 


A destination is attached to each output. A destination 
is either a station or a compound name of the type 
"station.stationl" (see below). 

The default destination is the attached station of the 
Job submitter . Otherwise it is specified by JCL 
(example: OUTVAL DEST=destination), or by 
operator commands (example: MO Xron 
DEST=destination). 


A station is a logical entity used to group several 
outputs. For the Output Writer, a station is an output 
writer queue. 


Name given to "station!" when the destination is in the 
form "station.station!". The secondary station is used 
by the Queued Writer to prefix the subfiles it creates. 

It may be a pseudo station. Its default value is MAIN. 

It must be 8 characters maximum. 
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H.3 Activation of the Queued Writer 


The Queued Writer is activated by the GCL Command 
START_OUTPUT_WRITER (SO or SOW). The format is: 


{START _OUTPUT|SOW|SO} ON=[$site:]library 
[SELCLASS=oclist] 
[DEVCLASS=devclass] 
[STATION=station] 
[DATAFORM= {SSF | ASA} ] 


Description of the Main Parameters 


site Specifies the name of the site to which the outputs are 
sent. The site must not be a remote site. 


library Specifies the name of the SL library to which the 
outputs are sent. This library must exist (it must 
already have been created, for instance with the 
BUILD_LIBRARY GCL command). SHARE=DIR is 
mandatory. 


oclist Specifies the list of classes on which the writer is 
started. The default is the class which was specified at 
configuration time. 


DEVCLASS Specifies the device class and the attributes of the 
output device. The default is the value which was 
defined at configuration time. 


STATION Specifies that the outputs the writer will take into 
account are those present locally in this station queue. 
If it is not specified, the operator's station is assumed. 


DATAFORM Specifies the format of the output file: SSF (System 
Standard Format: default) or ASA (American Standard 
Association format). 
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The Queued Writer starts when the file to which the outputs are sent is found to be 
a library. The parameters used in the startup command are checked, but not the 
actual existence of the library (until the Queued Writer selects an output for it). 


When the Queued Writer starts, the following message is sent to the operator: 
(OU06 SO Wnnn STARTED) 


hh.mn SOW successful: Wnnn started 
on lib: filename 
for station oclist dvc. 


where Wnnn is the name given to the writer (nn is a number attached to this 
writer). 
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H.4 Name of the Subfile to be Printed 
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The Queued Writer creates a subfile for each output. The names of the subfiles are 
as follows: 


<secondary station> Xron_outindex date _hour 


Where "Xron" (4 characters) and "outindex" (5 characters) are the run occurrence 
number and the outindex of the output; "date" (5 characters) is the year and day of 
the creation of the job; "hour" (4 characters: HHMM) is the hour and minute of 
the creation of the job. 


NoTE: 
For the JOB OUT, the sub-index is not used (only the outindex is used). Thus, 
the Queued Writer creates only one subfile for the JOB_OUT. 


<secondary_station> is the name of the secondary station (see above). It may be a 
pseudo station. This name is taken from the specification of the destination (in 
JCL, IOF, or by program): 


DEST=station.secondary station 


The default value for the secondary_station is MAIN. It must be 8 characters 
maximum. 
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H.5 JCL_CONTROL Subfile 


The member JCL_CONTROL contains a user-defined JCL. 


If JCL_CONTROL is present in the SL library, the Queued Writer executes it 
automatically. 


NOTE: 
The only exception is that JCL_CONTROL is not executed when you use 
GTWRITER or OPEN 7 on the SL library in which it is located. 


IMPORTANT: 
The JCL contained in JCL_ CONTROL is run after each and every output 
processed by the Queued Writer. 


Js) 


EXAMPLE: 
The following is an example of the user-defined content of JCL_CONTROL. 
SJOB JCL_ CONTROL JOR = ABORT; 


$SEND 'JCL CONTROL ACTIVATED! ; 
SENDJOB ; 


Q) 


H-6 47 A2 53US 


Queued Writer 


H.6 Termination of the Queued Writer 
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The Queued Writer is terminated like any writer by the 
TERMINATE OUTPUT_WRITER (TOW, TO) GCL command. The format is: 


{TERMINATE OUTPUT _WRITER|TOW|TO} ON={Wnnn|*} 
[Ssite: library] 
[SELCLASS=oclist] 
[STATION=station] 
[STRONG={0|1}] 


If STRONG is not specified, the Queued Writer is stopped when the current output 
ends. 


If STRONG is specified, the current output is stopped, the output is set to the 
"WAIT" state, and may only be reprocessed from the beginning (the question 
"RESTART FROM?" is not asked. 


If "oclist" is used, the writer stops working only on the specified output classes. 


H-7 
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A 


Active (Member, Server) 
In the Complex Management Service of the TDS High Availability product, the term ACTIVE 
SERVER designates the SERVER supporting the functional implementation of a SERVICE and 
ACTIVE MEMBER designates the MEMBER supporting this ACTIVE SERVER. 


ANTESP or ASPA (Ante Service Processor) 
An early version of the service processor on the DPS 7000/2x0/3x0. 


ARM (Automatic Resource Management) 
A GCOS 7 system administration and regulation tool. 


Automatic Initialization Mode 
Two different parameters exist: 


1. The Hardware Automatic Initialization mode (called ASPA AUTO in DPS 7000/2x0 and /3x0, 
SCC AUTO in the DPS 7000/An and AUSP AUTO in the 
DPS 7000/4xx/5x0/7xx/8x0/Dx0/Mx0. 


This is the automatic mode mentioned in Section 2. It is taken into account at the next 
complete hardware initialization. 


2. The GCOS 7 automatic initialization mode, that indicates whether or not a Reload should 
require the intervention of the operator during the ILO1 OPTIONS question. This is the 
automatic mode mentioned in Section 3. 


AVR (Automatic Volume Recognition) 
Whenever a device is put into the READY state, the system tries to identify the volume. This 
operation is called Automatic Volume Recognition. 
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B 


Backing Store (BKST) 
Due to limitations in main memory size, backing store files are used to contain permanent or 
temporary information and to temporarily store executing programs not being processed by the 
system. 


Backup (Member, Server) 
In the Complex Management Service of the TDS High Availability product, the term BACKUP 
SERVER designates the SERVER which implements the rescue function of a SERVICE and 
BACKUP MEMBER designates the MEMBER supporting this BACKUP SERVER. 


BFAS (Basic File Access System) 
The file access method used for sequential files organized with the Variable Block Organization 
(VBO). 


BIOS (Basic Input/Output System) 
A set of program, typically in firmware, that enables a DPS 7000/XTA CPU to communicate with 
peripheral devices before WINDOWS™ loading 


Bi-System 
Operating mode on a multiprocessor on which two operating systems can run. Peripherals 
accessible from the two systems are Shareable even though not described as such in the IRT. 


BSR (Basic System Release) 
The BSR contains the firmware source components. 


C 


CDA 7 (Cached Disk Array 7) 
A disk unit for DPS 7000/MTxx redundant models. 


CDP (Customer Dedicated Processor) 
On DPS 7000/MTxx, a CDP can be any co-processor that can be assigned to a function, to enhance 
its performance. Physically, CDPs can be EPUs, FPUs and GPUs. 
See domain, function (privileged), EPU, FPU, GPU. 


CMSC (Complex Management Service) 
The administration service implementing the TDS high availability features for release GCOS 7- 
V6 onwards. 


CMSR (Complex Management Server) 
The server implementing the administrative function on a member of the Complex Management 
Service. 


CNP7 (Communications Network Processor 7) 
The network processor that is fully integrated into the cabinet of the DPS 7000, Model A computer 
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Console or Operator Station Console 
The workstation from which the operation of a computer system can be monitored and controlled. 


Complex 
Term used to designate the set of members implementing the TDS high availability features for 
release GCOS 7-V6 onwards. 


Coupled Systems 
Two installations with common peripheral resources. 


CRCXGEN (Create Complex Generation) 
Description and generation processor for a complex. 


Crash 
GCOS 7 operating system session abnormal termination. 


Crash Reasons 
Crash attribute that describes previous operating system session crash originator: System 
Exception, Call to Panic, Channel Exception, IOP Exception, System Restart, Hardware Failure. 


D 


Device Identifier (dvnm) 
The device identifier is made up of the 2 letters for the device type and the 2 characters for number 
(e.g. PRO1). 


Device Type (dvtyp) 
Each device belongs to a device type identified by two letters (e.g., PR = printer). Each device of a 
device type is identified by a device number (2 digits or letters). 


Device Reconfiguration 
If the operator mounts a removable volume (typically a cartridge or a magnetic tape) on a device 
other than the device requested by the system, AVR reads the volume name and directs the job to 
this new device. This is called, Device Reconfiguration. 


Dimension 
A set of rules pertaining to memory, CPU and multiprogramming used by the Automatic Resource 
Manager (ARM) 
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Domain 
On DPS 7000/MTxx, a domain represents a kind of CPU resource. A domain exists if the 
corresponding hardware configuration exists (general purpose CPU, or CDP co-processor). There 
are four domains: 


Standard 
CDP1 
CDP2 
CDP3 


See CDP, function, IPU, EPU, FPU, GPU. 


Double Failure 
In the Complex Management Service of the TDS High Availability product, the term DOUBLE 
FAILURE indicates the situation where the two COMPLEX MEMBERs have successively crashed 
without the CMSRs being able to resynchronize themselves. 


DPCV 
The standard load module that converts a BKST type system dump output file into a UFAS indexed 
file ready for access by the DUMP ANALYZER service. 


Dump 
The operator can either print, display, or store for later printing, the dump (GCOS 7 address space 
image) of the previous session. 


E 


EPU (Extended Processor Unit (type 1)) 
On DPS 7000/MTxx, a processor for a all privileged functions, corresponding to CDP1. 
See CDP, domain, privileged function 


F 


FBO/VBO (Fixed/Variable Block Organization) 
These are methods for data organization on disks. The fixed mode, which organizes the data in 
blocks of fixed length, is tending to gradually take the place of the variable mode. 


FDA 7 (Fiber Disk Array 7) 
A disk subsystem for DPS 7000 models, allows user’s disks to be secured with RAID1 
mechanism. 


FEP (Front End Processor) 
Communications processor that manages connections to data networks. 


FEPS (Front End Processor Server) 
The GCOS 7 communications server that manages a Datanet interface. 
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FF1 (Full Form 1) 
This is a logical page for printing used with the SYS.URCINIT printer control facility. 


File Salvaging 
Following a crash or any other abnormal termination of the previous session, action is taken to 
establish the state of files open at the time. Decisions are made about whether these files can be 
restored, kept or lost. 


Form 
This refers to a paper page in printer control. 


FORMHT 
Form height in line numbers. 


FPU (Extended Processor Unit (type 2)) 
On DPS 7000/MTxx, a processor for a privileged function specified by the administrator, 
corresponding to CDP2. 
See CDP, domain, privileged function. 


Function (privileged function) 
On DPS 7000/MTxx, a function is a set of applications that can be privileged or not. A privileged 
function can be assigned to a domain. The following functions are privileged: 


SYSTEM 
ORACLE 
OPEN 7 
DW7 


IQS 
See CDP, domain. 


G 


GAC (General Access Control) 
This GCOS 7 Facility enables several users in any of the three processings, Batch, IOF (IQS) and 
TDS, to access the same resources concurrently. 


Galileo 
An external peripheral controller which is used to connect on DPS 7000 platforms the Powersave, 
PowerExchange and Opensave offers. 


The GCOS 7 external device type is equivalent to a CT/M6 device.GCL (GCOS 7 Command 
Language) 
The current set of CGOS7 commands providing a user-friendly interface with menus and prompts 
for the operator. 


GCOS 7 (General Comprehensive Operating System 7) 
The operating system of the DPS 7000 family of computers. 
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GPL (GCOS 7 Programming Language) 
A programming language for systems programmers who develop advanced applications similar to 
GCOS 7 basic software. 


GPU (Extended Processor Unit (type 3)) 
On DPS 7000/MTxx, a processor for another privileged function specified by the administrator, 
corresponding to CDP3. 
See CDP, domain, FPU, privileged function. 


H 


HA (High Availability) 
This is a term used in the Complex Management Service of the TDS High Availability product. A 
SERVICE is said to be in HA mode if it has been mapped on two MEMBERs at COMPLEX 
generation. 


HOF (Head Of Form) 
This is the logical starting point for printing. 


HRD (High Reliability Disk) 
Disk accessed through a sub-system ensuring high reliability. 


Initialization 
Consists of several phases, which can be divided into two categories: 


1. Loading operating systems necessary to proper system operation (GCOS 7, the main operating 
system, is loaded after SPOS the service operating system. There is also a variety of other 
modules such as SPI, SIP, or MID, that we are not concerned with here). 


2. Testing the correct functioning of the system. 


Installation 
The largest possible system than can be built on one site. i.e. the total resources than can be 
controlled from one Service Processor. 


IOF (Interactive Operation Facility) 
The GCOS 7 versatile time-sharing system that can operate in batch, remote batch and 
transactional contexts. 


IPU (Instruction Processor Unit) 
On DPS 7000/MTxx, a general-purpose (or standard) processor. It provides the STANDARD 
domain resources. 
See CDP, domain, FPU, privileged function. 
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IRT (Installation Resource Table) 
A file describing the installation configuration. It is loaded at system initialization time and is used 
to build the SRST. 
On DPS 7000/XTA platforms, the GCOS 7 resources are managed by the V7000 software. IRT is 
no more used. 


ISL (Initial System Load) 
The last phase of system initialization. ISL loads the GCOS 7 operating system into main memory. 


J 


JAS (Journalization Advanced Service) 
The GCOS 7 service that guarantees the integrity of a set of user files. In the Complex 
Management Service of the TDS High Availability product, a JAS SERVICE is SWITCHABLE 
when there are no MIXED JOBS or non-HA TDS jobs running. 


JCG (Job Class Group) 
A 'mother' job class associated with one or several 'daughter' job classes, used by ARM. 


Job 
Work that is processed in a GCOS 7 system. A job is introduced, scheduled, executed and output. It 
is identified by a run occurrence number (ron) and has a job-class. 


Job Checkpoints 
In case of error in the processing of a job, one can restart the processing, not completely from the 
beginning, but from the latest in a series of steps in the process, known as checkpoints. 


Job Class 
This is a composite object larger than a job. A job-class is modified, executed, held, given 
priorities, etc. 


Job Input Queue 
After a job has been introduced to the system and is not HELD, it is placed in a scheduling queue 
to be selected for execution. Its place in this schedule depends on its scheduling priority, or by 
default, the priority of its class and its FIFO (First In First Out) position in that class. 


Job Outputs 
After job execution, the resulting job output is printed or stored on magnetic media. 
L 


LEVEL (I and ID) 
In the Complex Management Service of the TDS High Availability product, the term LEVEL refers 
to different levels of availability offered by the CMSC. 


LOS (Level of Simultaneity) 
The number of simultaneous data transfers that can be performed on a set of peripheral devices. 
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MAIN Operator 
An operator registered in the site catalog with the MAIN attribute. 


MAM (Message Access Method) Message Queues 
These are queues for communications messages, stacked in order to establish or retrace the events 
concerning a job run over the network. At Restart, various actions are possible regarding these 
queues, for example, elimination, or storage for rollback. 


Member 
A GCOS 7 host system that is integrated into a Complex of the GCOS 7 High Availability facility. 


Millennium Application Test Facility 
On DPS 7000/MTxx, the ability to test an application with a private date within one GCOS 7. 


Millennium Bi-System Test Facility 
On DPS 7000/MTxx, the ability to run two versions of GCOS 7 with two different dates for 
production and test purposes. 


MIRROR disks 
A pair of disks that have the same name, the same device attributes, the MIRROR attribute, the 
same volume label, plus the mirror extension, MIRLAB. They are ordered hierarchically Primary 
and Secondary. The user sees this pair as one logical disk. 


Mixed Job 
In the Complex Management Service of the TDS High Availability product, the term MIXED JOB 
designates a batch or an IOF job which uses simultaneously an HA JAS and a non-HA JAS. 


MSP (Mass Storage Processor) 
Subsystem controller. 


MSPD 
ORU name for a SCSI drive and streamer controller. 


Multiprogramming 
Execution of two or more unrelated programs on the same computer. 


O 


OCL (Operator Command Language) 
The older GCOS 7 command set that is still operational, but without the menus and other user- 
friendly features of the newer GCL. 


OPR (Output Priority) 
Used to queue outputs waiting to be processed by the writer service job. 
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P 


POP (Programmed Operator) 
A facility of the DPS 7000 5x0/7xx/8x0/Dx0/Mx0 computers that runs various services without 
operator intervention, for example: automatic initialization. 


PMOS (Programmed Operator Support) 
A program, that can be installed locally or at a remote site, which executes many of the routine 
actions of the main GCOS 7 operator. 


Power-on (or Power-up) 
The action of applying power to the system. When the Hardware Initialization mode is in 
automatic - the normal situation on all DPS 7000 systems - this is followed by initialization, 
without any operator intervention required. 


R 


Redundant (System) 
The term REDUNDANT is used in this manual for systems having major components that are in 
duplicate to prevent failure of the system in case of breakdown of a component. 


Reference Level 
In printing, this is the paper position when the paper fold coincides with a mark located on the 
tractors. 


Reload 
The action of performing again the Jnitial Storage Load after a System Termination. 


Remote Operator 
A correspondent intervening on the system by use of the network. 


Restore 
If the CONFIG job has been run or a new technical status installed then a RESTORE is mandatory. 
Equally if segments of the SYS.BKST or SYS.LIB files have been corrupted due to a physical 
Input/Output error, then this file must be restored from the SYS.SYSTEM file using the FORMAT 
option. 


RLN (Remote Line Handler). 
A service of the AUSP Service Processor. 


RON (Run Occurrence Number) 
GCOS 7 gives a ron identification number to each job in the system. By this number, an operator 
can identify a job once introduced. 


RMOS (Remote Multiplexed Operator Support) 
An interactive processor under IOF that enables the monitoring of applications at different sites 
from a single terminal without having to log-on/log-off. 
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Restart 
Cold 
Warm 
Clean 


Ss 


SDA 7 (Small Disk Array 7) 
A RAIDI1 disk unit which provides 20 GB to 40 GB per cabinet. It can be: 


e connected to Bull DPS 7000/MTxx non-redundant systems, 
e connected to Bull open systems, 
e shared between Bull DPS 7000/MTxx non-redundant systems and Bull open systems. 


Segment 
In printing, this designates repetitive series of characters on a belt. 


Service Disk (on DPS 7000/An) 
A disk containing the Service Processor files (for loading SPOS, handling errors, etc.). It is 
processed by GCOS 7 as a BKST disk and displayed as SRV by the DHW command. 


Server 
This is a term used in the Complex Management Service of the TDS High Availability product. A 
SERVER is the result of the projection of a SERVICE on a MEMBER. All the SERVERS 
implementing the same SERVICE have the same name, which is the name of the corresponding 
SERVICE. 


Service 
This is a term used in the Complex Management Service of the TDS High Availability product. A 
SERVICE is the implementation of a functional component. Its name is declared by the SERVICE 
administrator. Today, there are three types of SERVICE: JAS, TDS and ORACLE. 


SM (Shareable Modules) 
These are system modules that can be accessed in the processing of different jobs at the same time. 


SMD (Server Management Dialog) 
Administrative protocol between the servers of a Complex and the Complex Management Service. 


SPI (Service Processor Assy Language Interpreter) 
A utility used in the Service Processor of the DPS 7000/2X0/3X0 computers. 


Space Line 
In printing, this is the minimum space between two printed lines. 


SPOS (Service Processor Operating System) 
The operating system used by the Service Processor of the DPS 7000/2X0/3X0 computers. 
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SPR (Scheduling Priority) 
Used with job classes to control the order in which jobs are queued and selected for scheduling. 


SRST 
System Resource and Status Table. At initialization, the System Initialization Program (SIP) 
updates the IRT image, according to the actual state of the configuration, to produce the SRST for 
that system. The SRST is visible to the Operating System. 
On DPS 7000/XTA platforms, the SRST is managed by V7000 software. SIP and IRT are not used. 


SSI 
Storage Server Interface. This is a CLX process located: 
- on the ACSLS server for the DPS 7000/XTA platforms 
— or ona local OPEN7 subsystem for all other DPS 7000 platforms. 


Stop Level 
VFU channel entry/hole. 


Substitution Character 
Character to be printed instead of a combination that is not present on the belt. 


SW (Switchable) 
In the Complex Management Service of the TDS High Availability product, a SERVICE is said to 
be SWITCHABLE if it can be switched from one system to the other. 


SYC (System Control) 
A Software service which is used to control the DPS 7000 platforms: it allows for example the 
system initialization, system reload, system restart commands. 


System Disk 
The disk containing the SYS.BKST (or BKSTO) file. This disk is automatically resident, although 
the RSDT attribute is not displayed by the DHW command. 


System Operator Panel(s) (SOP) 
The panel(s) used by the operator to control and monitor CSS initialization and operation. They are 
illustrated and described in Section 2 of the present manual. 


System Reset (or Re-initialization) 
The action of completely repeating initialization, as if a power-off/power-on command had been 
entered. 


System Termination 
A system termination can occur in two ways: 
Normal termination is requested by the operator using the TSYS command. 
Abnormal termination occurs when the system crashes, following an error that cannot be overcome 
by the GCOS 7 operating system. 
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T 


TA (Twin Architecture) 
A DPS 7000 series (DPS 7000/TAxxx) which is the first DPS 7000 series to promote the Twin 
Architecture (GCOS 7 and Open world on the same server). 


Takeover 
In the Complex Management Service of the TDS High Availability product, the term TAKEOVER 
refers to the operation where a SERVER is switched from the BACKUP state to the ACTIVE state. 


Terminal 
A device connected to the network and accessed by telecommunications software. 


U 


UFAS (Unified File Access System) 
The UFAS Extended access method is versatile in its operation and it supports files with different 
organizations including data base files. UFAS Extended is the most used access method with 
GCOS 7. 


Used-Service 
In the Complex Management Service of the TDS High Availability product, the term 
USED-SERVICE refers to a SERVICE that is used by another SERVICE. 


V 


V7000 (Virtual DPS 7000) 
A Firmware and software product enabling GCOS 7 programs to run on an Intel™ architecture 


based server. 
This product is the base of the DPS 7000/XTA platforms. 


VBO/FBO (Variable/Fixed Block Organization) 
These are methods for data organization on disks. The fixed mode, which organizes the data in 
blocks of fixed length, is tending to gradually take the place of the variable mode. 


VEU (Vertical Format Unit) 
In printing, this is a set of channels containing predefined stop levels for automatic page printing. 


VMM (Virtual Memory Manager) 
The GCOS 7 component that manages main memory and backing store to provide the virtual 
address space visibility. 


Volume (file) 
Disks, tape reels, and tape cartridges are referred to as volumes. A Volume contains one or more 
files. Each file is, for the user, a set of information. 
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Volume Name 
Disks, cartridges, and magnetic tape volumes are identified by their Volume Name (volnm). The 
term volnm is used throughout this manual for convenience, but the volnm may in fact be 
alphabetic, alphanumeric or numeric. 


VOS (V7000 Operation Supervisor) 
A V7000 service used on a DPS 7000/XTA platform to manage the server activity. 


W 
WSP (Wide SCSI Processor) 
A controller for wide SCSI disk or cartridge subsystem connections. 


xX 


XPR (Execution Priority) 
Controls CPU sharing between executing steps during multiprogramming. 


XTA (eXtended Twin Architecture) 
A DPS 7000 series which is a major evolution of the DPS 7000/TA platform. 
This DPS 7000/XTA platform runs GCOS 7 programs on an Intel™ architecture based server 
whereas the previous DPS 7000 platforms run GCOS 7 programs on a Bull proprietary CPU 
chipset . 
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